# 集群版安装

# 1. 准备安装文件

首先获取 HeyCloud 安装包，安装包是一个名为 heycloud-xxx.zip 的压缩包。将这个压缩包解压，以 Ubuntu 为例：

$ sudo apt install unzip
$ cd ~
$ unzip heycloud-xxx.zip -d heycloud
$ cd heycloud

# 2. 确认 Docker 已安装

在集群的所有主机安装 Docker，建议使用虚拟机操作，先准备好一台安装好 Docker 的主机，然后进行克隆。

如可联网，可以可以参考步骤3解压安装包以后，直接运行安装脚本进行安装，注意，首次安装后需要退出帐号重新登录。

$ ./system-requirements/setup-docker-ubuntu22.sh
$ exit
$ su - geohey

Docker 的安装请参考：https://docs.docker.com/engine/install/

# 3. 执行安装

安装在管理节点上进行，执行安装前需要先修改 apps/HOSTS 文件，设置各个节点的 IP。注意，只有 hosts_app 需要设置多个节点，其余类型都只需要一个节点。

设置完成后，在解压的 heycloud 目录下执行：

$ ./heycloud cluster install

# 4. 启动 HeyCloud

在管理节点上执行启动脚本：

$ ./heycloud cluster start

此时会看到控制台打印出各个服务启动的命令，直到脚本执行结束。注意，脚本执行结束并不代表 HeyCloud 已启动成功，HeyCloud 中的微服务互相有依赖关系，因此服务的启动过程会反复互相确认服务状态并可能重启服务。因此只有当确认所有服务都已启动时，才代表 HeyCloud 已经完全启动。查看服务状态可以执行状态脚本：

$ ./heycloud cluster status

如图 REPLICAS 列前后数值相等，并且都大于0代表所有服务已正常启动。

# 5. 初始化数据

首次安装时，在确认 HeyCloud 已经成功启动后，在管理节点上执行初始化脚本：

$ ./heycloud cluster init

注意，后续升级版本等操作不需要执行初始化，该操作会将所有数据重置！

# 6. 设置 IP 和端口

此时，HeyCloud 所有 API 已能够正常工作，管理控制台可以通过管理节点的 IP 访问到。为了安全性 HeyCloud 很可能还会部署在一个反向代理服务器后，所以，如有需要还可以更新 HeyCloud 所在的 IP 和端口：

$ ./heycloud cluster set-address

此时命令行会提示输入 HeyCloud 所在的 IP 和端口，例如 HeyCloud 部署的集群主节点为局域网内一台 IP 为 192.168.1.200 的节点，使用默认的 9000 端口，那么执行脚本后如此输入：

HeyCloud 所在的 IP 也可以使用域名表示

# 7. 确认安装成功并设置管理员密码

此时，通过浏览器访问 http://<管理节点ip>:<port>/heycloud (如果管理节点 IP 是 192.168.1.123，那么管理控制台地址就是 http://192.168.1.123:9000/heycloud) ，如果能够看到管理控制台的页面，并可以按照提示成功设置管理员密码，代表 HeyCloud 安装成功。

# 8. 更新版本

同一个大版本的产品可以进行更新，比如同为 1.x.x 的版本。更新只需要执行更新脚本，脚本会提示输入新的安装包的路径，此时输入完整的 zip 文件的路径即可。

$ ./heycloud cluster update

← 单机版安装卸载 →