安装前配置

安装 Kubernetes

SuperMap ImageX Server for Kubernetes 目前仅支持在 Kubernetes 1.20以上版本上运行，如果已有 Kubernetes 环境，可跳过此步。详细部署步骤可参考安装 Kubernetes。

安装 Serverless

SuperMap ImageX Server for Kubernetes 运行还需要部署 Serverless 相关的基础服务。详细部署步骤可参考安装 Serverless。

安装 NFS Server

本例以 CentOS 系统为例，Ubuntu 系统安装方法类似。如果已有 NFS 服务器或者只用于单节点部署，可以跳过此步。

NFS Server 离线安装包准备，需根据使用的操作系统下载对应版本的 NFS Server 离线安装包，例如：
- nfs-server-offline-centos-7.5.zip
在本机解压 nfs-server-offline-centos-7.5.zip，得到 supermap-nfs-server 文件夹。
拷贝 supermap-nfs-server 文件夹到任意一台机器。
输入如下命令进入 supermap-nfs-server 文件夹： cd supermap-nfs-server
输入如下命令执行安装脚本：
```
sudo chmod +x install.sh &&./install.sh
```

安装后 nfs 的默认存储路径为：/opt/nfs_data。root 用户可以通过以下方法验证 NFS 安装是否成功：

mkdir test
mount -t nfs <ip>:/opt/nfs_data test

其中：<ip>为 NFS Server 所在机器的 ip地址。

非 root 用户可以通过以下方法验证 nfs 安装是否成功：

service nfs status

结果如下图则安装成功：

导入镜像

镜像包准备（如可访问互联网使用阿里云镜像仓库，则忽略该步。使用时请替换为实际包名)

supermap-imagex-enterprise-for-kubernetes-*-registry-all.tar.gz

步骤大致如下：

解压镜像包
将镜像包放置在机器（可以是安装了 Kubernetes 的任意机器）的任意目录，如：/home/，使用以下命令解压（在执行命令时请替换为实际包名）：
```
tar -zxf supermap-imagex-enterprise-for-kubernetes-*-registry-all.tar.gz
```
导入imagex-enterprise镜像
- 进入解压后根目录（以实际包名为准）:
```
cd supermap-imagex-enterprise-for-kubernetes-*-registry-all
```
- 在当前目录执行以下命令，进行安装镜像库：
```
chmod +x setup.sh && ./setup.sh registry_url=<ip>:5000 registry_insecure=true registry_user=<your-username> registry_password=<your-password>
```
  其中：
  - registry_url（必填），镜像仓库地址。
  - registry_insecure，镜像仓库是否 http 的，true表示http的，默认 false。
  - registry_user，如果私有仓库配置了密钥，这是填访问私有仓库的用户名。没有配置密钥则忽略。
  - registry_password，如果私有仓库配置了密钥，这是填访问私有仓库的用户名对应的密码。没有配置密钥则忽略。
如果没有私有镜像仓库，请执行以下命令搭建镜像仓库：
```
docker load -i $(pwd)/images/registry.tar
```
```
docker run -d -p {镜像服务端口}:5000 --name private-registry -v {镜像存储路径}:/var/lib/registry registry.ispeco.com/registry:2.6.0
```
其中，请将镜像服务端口和镜像存储路径替换为实际期望的值，如
```
docker run -d -p 5000:5000 --name private-registry -v /mnt/nas/image_registry:/var/lib/registry registry.ispeco.com/registry:2.6.0
```
然后再执行以下命令导入镜像：
```
chmod +x setup.sh && ./setup.sh registry_url=<ip>:{镜像服务端口} registry_insecure=true
```
访问镜像库，验证是否安装成功
```
docker pull <ip>:5000/supermap/scratch:latest-amd64
```
其中：<ip> 是所在主机的IP。如果镜像地址有修改，以实际值替换。

如果结果无错误提示，则启动成功。

如果是在 ARM 环境下，需要将镜像 tag”latest-amd64“更改为 “latest-arm64“。即：
```
docker pull <ip>:5000/supermap/scratch:latest-arm64
```

开放端口

SuperMap ImageX Server for Kubernetes 基于 values.yaml 编排文件中的配置进行安装，您需要将编排文件中以下配置使用的端口预留出来，避免端口无法使用导致安装失败：

cloudsuite_keycloak_port：默认值 32221，自定义端口范围为 30000-32767
http_port：默认值 32222，自定义端口范围为 30000-32767
https_port：默认值 32223，自定义端口范围为 30000-32767

同时，还需要预留出 NFS 存储相关的端口：6443、8443、2049，以及 8080、9100 端口。

如果您是使用阿里云 ECS 服务器，您需要将以上端口添加到安全组规则中。除此以外，还需要确保 3307 和 9183 端口不被占用。

安装 Kubernetes

安装 Serverless

安装 NFS Server

导入镜像

开放端口

相关主题