【k8s】Rocky Linux部署k8s1.31.14+KubeSphere

编码如写诗

发布于 2025-11-19 19:13:05

450

文章被收录于专栏：编码如写诗编码如写诗

本文演示以x86-RockyLinux刚装完系统环境下all-in-one，使用4条简短的命令在线/离线部署k8s 1.31.14+ks3.4.1(监控、告警、日志),若有其他需要可添加我微信好友sd_zdhr。

下一篇演示，由1个master节点扩展为3个master节点

1.说明

关于kt

kt是基于kk二次开发的产物，具备kk的所有功能。二开主要为适配信创国产化环境、简化arm部署过程和国产化环境离线部署。支持arm64和amd64架构国产操作系统，已适配芯片+操作系统如下。

kt 新增功能点

适配arm架构harbor和支持，部署体验与X86一样简单。
离线环境部署增强。常用国际和国产操作系统依赖，内置到安装包中。已适配芯片和操作系统如下
- ./kt init-os 一条命令完成操作系统依赖安装和初始化操作。
- CPU：鲲鹏、飞腾、海光、兆芯、intel、amd等。
- OS：Centos、Rocky Linux、Ubuntu、Debian、银河麒麟V10、麒麟V11、麒麟国防版、麒麟信安、中标麒麟V7、统信UOS、华为欧拉、移动大云、阿里龙蜥等。
支持开启防火墙，只暴露30000-32767端口，其他k8s端口添加到节点白名单。
- ./kt firewall 一条命令自动获取节点信息开白名单和防火墙。

kt 版本更新和下载地址

kt：kt[1]
关注我不迷路

2.环境准备

服务器基本信息

主机名	架构	OS	配置	IP
all-in-one	x86_64	Rocky Linux 8.10	4核8G	192.168.85.160

将对应架构kt-x86.tar.gz上传至服务器

本文使用kt:3.1.12版本，支持截至2025-11-16发布的所有k8s版本，由于新版本k8s要求etcd最低3.5.24，这里升级kt默认版本为3.6.6，并同步修改etcd对应脚本。

2.1 系统初始化

操作系统不需要安装docker,不需要设置selinux,swap等操作，全新的操作系统即可。解压kt文件后执行./kt init-os 已适配操作系统和架构见1.说明

该命令kt会自动判断操作系统和架构以安装依赖项和进行必要的初始化配置。

3 创建 Harbor私有仓库

3.1 上传离线制品

将离线制品、配置文件、kt和sh脚本上传至服务器其中一个节点，后续在该节点操作创建集群。

3.2 创建集群配置文件

~~主要修改相关节点和harbor信息，用于生~~~~config-sample.yaml~~

~~使用网盘中的配置文件，不再使用以下命令生成的。~~

./kt create config --with-kubernetes 1.31.14 --with-kubesphere 3.4.1

3.3 修改配置文件

根据实际服务器信息，配置到生成的config-sample.yaml中

kind: Cluster
metadata:
  name: sample
spec:
  hosts:
  - {name: node1, address: 192.168.85.160, internalAddress: 192.168.85.160, user: root, password: "123456"}
  roleGroups:
    etcd:
    - node1
    control-plane:
    - node1
    worker:
    - node1
    # 如需使用 kk 自动部署镜像仓库，请设置该主机组 （建议仓库与集群分离部署，减少相互影响）
    # 如果需要部署 harbor 并且 containerManager 为 containerd 时，由于部署 harbor 依赖 docker，建议单独节点部署 harbor
    registry:
    - node1
  controlPlaneEndpoint:
    ## Internal loadbalancer for apiservers 
    # internalLoadbalancer: haproxy

    domain: lb.kubesphere.local
    address: ""
    port: 6443
  kubernetes:
    version: v1.31.14
    clusterName: cluster.local
    autoRenewCerts: true
    containerManager: docker
  etcd:
    type: kubekey
  network:
    plugin: calico
    kubePodsCIDR: 10.233.64.0/18
    kubeServiceCIDR: 10.233.0.0/18
    ## multus support. https://github.com/k8snetworkplumbingwg/multus-cni
    multusCNI:
      enabled: false
  registry:
    type: harbor
    registryMirrors: []
    insecureRegistries: []
    privateRegistry: "dockerhub.kubekey.local"
    namespaceOverride: "kubesphereio"
    auths: # if docker add by `docker login`, if containerd append to `/etc/containerd/config.toml`
      "dockerhub.kubekey.local":
        username: "admin"
        password: Harbor@123 # 此处可自定义，kk3.1.8新特性
        skipTLSVerify: true # Allow contacting registries over HTTPS with failed TLS verification.
        plainHTTP: false # Allow contacting registries over HTTP.
        certsPath: "/etc/docker/certs.d/dockerhub.kubekey.local"
  addons: []
---
apiVersion: installer.kubesphere.io/v1alpha1
kind: ClusterConfiguration
metadata:
  name: ks-installer
  namespace: kubesphere-system
  labels:
    version: v3.4.1
 ...

说明：这里写一下注意事项

config-sample.yaml 配置文件的 spec:hosts 参数

官方介绍

address 服务器的 SSH 登录 IP 地址。
internalAddress 服务器在子网内部的 IP 地址。

注：若部署的服务器在同一区域，内网IP可以互通，address 和internalAddress 都使用内网IP。之前遇到过有的小伙伴买的云服务器做测试，address使用公网IP，由于部署过程通信拷贝文件走了address，公网带宽又低。导致创建集群时异常的慢。

3.4 创建Harbor镜像仓库

注意：harbor必须用docker,所以所在节点需要用docker运行时。

./kt init registry -f config-sample.yaml -a artifact-amd-k8s13114-ks341.tar.gz

此命令会在harbor节点自动安装docker和docker-compose

3.5 创建harbor项目

说明：

Harbor 管理员账号：admin，密码：Harbor@123。密码同步使用配置文件中的对应password

harbor 安装文件在 <font style="background-color:rgb(255,245,235);">/opt/harbor</font> 目录下，可在该目录下对 harbor 进行运维。

安装完成后，等待容器全部启动完成(大概1分钟)，通过执行docker ps 查看状态

创建 Harbor 项目

chmod +x create_project_harbor.sh && ./create_project_harbor.sh

4 创建k8s和KubeSphere

./kt create cluster -f config-sample.yaml -a artifact-amd-k8s13114-ks341.tar.gz

此命令kt会自动将离线制品中的镜像推送到harbor 私有仓库

执行后会有如下提示,输入yes/y继续执行

等待一段时间，直至出现熟悉的等待安装完成的小箭头>>--->

期间可以另开一个窗口用以下命令查看部署日志

kubectl logs -n kubesphere-system $(kubectl get pod -n kubesphere-system -l 'app in (ks-install, ks-installer)' -o jsonpath='{.items[0].metadata.name}') -f

继续等待一段时间最终可以看到安装成功的消息