安装组件包

一、获取组件包

在开始安装云空间管理端之前，请获取最新发布的组件 bin 包，并上传到对应的虚拟机节点中：

astute-k3s-deploy*.bin：上传到 所有节点（用于搭建容器集群）。
astute-xspace-image*.bin：仅上传到 主节点（用于准备容器镜像）。
astute-xspace-deploy*.bin：仅上传到 主节点 (用于部署云空间管理组件)。

注：

可以通过 sftp 工具上传，或在虚拟机中用 wget 或 curl -O 命令下载。

若在鲲鹏/飞腾（ARM 架构）服务器上部署，请务必获取 arm aarch64 架构的安装包。

本例中，主节点 IP 为 192.222.8.151。

二、安装前通用说明

2.1 语言界面设置 (可选)

在执行任何组件包（k3s-deploy、xspace-image 或 xspace-deploy）时，您可以通过命令行参数指定安装向导的语言界面：

使用英文界面：添加 -- -E 参数。

[root@host151 ~]$ bash ./astute-k3s-deploy-*.bin -- -E

恢复中文界面：添加 -- -Z 参数。

[root@host151 ~]$ bash ./astute-k3s-deploy-*.bin -- -Z

重要提示：

参数持久性：-E 或 -Z 参数仅需在第一次执行组件包时输入。脚本会自动修改 /etc/profile 配置文件，后续安装其他组件包时会自动沿用该语言设置，无需再次输入。

适用范围：该参数适用于上述提到的所有三种组件包（k3s搭建、镜像准备、管理组件部署）。

2.2 安装可重入性说明

本系统的安装脚本具备 “可重入” 特性：

容错机制：如果在组件安装过程中（k3s 搭建、镜像准备、或管理组件部署），因网络中断、误操作或其他原因导致进程终止，您无需清理环境，也无需从头开始。
操作方法：只需 再次执行刚才中断的安装命令 即可。脚本会自动检测已完成的阶段并跳过，从断点位置继续执行直到完成。

三、构建容器集群

请在每个节点上执行 astute-k3s-deploy 安装包。

注意：必须先安装所有从节点，最后安装主节点。

3.1 具体操作步骤大纲

如果安装的是从节点：
- 选择网卡
- 设置主机名
- 选择从节点模式
如果安装的是主节点：
- 选择网卡
- 设置主机名
- 选择主节点模式
- 指定主节点（通常只有当前节点，直接确定即可）
- 指定从节点（通常有两台从节点，请手工填写从节点的主机名和 IP 地址）

3.2 先安装从节点 (Slave)

在所有从节点（如 152、153）上分别执行以下操作：

[root@host152 ~]$ bash ./astute-k3s-deploy-6.0_oe2203_x64.4.bin

交互指南：

选择网卡：

设置主机名：

默认规则：主机名默认生成为 hostxxx，其中 xxx 是对应节点内网 IP 地址最后一个字节的数值（例如 IP 为 192.222.8.152，则默认主机名为 host152）。

选择从节点模式（在“是否设置为主节点”处选 “否”）：

3.3 再安装主节点 (Master)

确保所有从节点安装完成后，在主节点（151）上执行：

[root@host151 ~]$ bash ./astute-k3s-deploy-6.0_oe2203_x64.4.bin

交互指南：

选择网卡与主机名：参考上述步骤。
选择主节点模式（选择 “是”）：

填写主节点列表（通常直接确定）：

填写从节点列表（手工填写从节点的主机名和 IP 地址）：

配置 NTP 服务器（可选）：

3.4 重要安全与账号说明

在 astute-k3s-deploy*.bin 的执行过程中，系统会自动将 root 账号密码修改为随机的复杂密码。
脚本执行后，系统中会自动新建 xspace 用户账号。
建议之后使用 xspace 用户登录进行日常运维，执行系统级命令时加上 sudo 即可，或通过 sudo su 切换到root账号。

3.5 验证集群状态

在主节点上检查，确保所有节点处于 Ready 状态：

[xspace@host151 ~]$ sudo kubectl get nodes
NAME      STATUS    ROLES                  AGE   VERSION
host153   Ready     <none>                 5m    v1.24.9+k3s1
host152   Ready     <none>                 5m    v1.24.9+k3s1
host151   Ready     control-plane,master   5m    v1.24.9+k3s1

四、准备容器镜像

当多节点容器集群搭建完成，确认所有节点都处于 Ready 状态后，请在 主节点 上执行镜像包安装：

[xspace@host151 ~]$ sudo bash ./astute-xspace-image.6.0.65.bin

安装完成后，将会看到如下完整的镜像仓库资源输出：

正在获取本地镜像仓库资源列表：
{
    "repositories": [
        "bitnami/minio",
        "bream-common",
        "canal/canal-adapter",
        "canal/canal-admin",
        "canal/canal-server",
        "descheduler/descheduler",
        "docker.io/bitnami/minio-client",
        "docker.io/busybox",
        "docker.io/easzlab/nfs-subdir-external-provisioner",
        "docker.io/mariadb",
        "docker.io/minio/minio",
        "docker.io/nacos/nacos-server",
        "docker.io/seataio/seata-server",
        "elastic/filebeat",
        "elasticsearch",
        "emqx/emqx",
        "jdk",
        "kibana",
        "logstash",
        "memcached",
        "migration-common",
        "mist/rabbitmq",
        "mist-ce/mist-api",
        "mistce/api",
        "mistce/api/v4-7-1",
        "mongo",
        "openresty/openresty",
        "perconalab/percona-xtradb-cluster-operator",
        "redis",
        "rocketmq-broker",
        "rocketmq-console",
        "rocketmq-namesrv",
        "wurstmeister/kafka",
        "wurstmeister/zookeeper",
        "xspace-common",
        "xuchengen/rocketmq",
        "xxl-job-admin"
    ]
}
本地镜像仓库中的可用镜像资源列表如上。

五、部署管理端组件

基础镜像准备就绪后，在 主节点 上执行云空间管理组件部署包：

[xspace@host151 ~]$ sudo bash ./astute-xspace-deploy-6.16.10.xxxxx.bin

注意：

该步骤安装时间较长，请耐心等待。

若过程中遇到超时提示，通常是因为组件启动压力大，请尝试输入 Y 确认重试。

xxxxxx 超时未启动，请稍候选择重试[Y]，或退出安装[N]:
+ read input
Y