入门

可视化安装GIS云套件

用于在Kubernetes环境下，通过SuperMap iManager部署中心提供的安装向导快速部署GIS云套件。

安装产品

注意：

如果您之前已通过部署中心安装过GIS云套件，并需要一个新环境，请先在部署中心->部署界面一键卸载再重新安装。由其他方式部署的GIS云套件环境，您需要使用相应的方式来卸载或删除。

再次安装时将保留您上次的配置选项，以便您快速完成相应配置。

如果您使用的环境已经部署过许可中心，则账户密码必须和上一次保持一致，请谨慎设置！如果业务需要二次修改许可中心账户密码，则请先卸载已部署的GIS云套件，清空kubernetes节点上的 /opt/bslicense/data 目录，重新部署GIS云套件，在部署过程中完成许可中心账户密码的设置，并在部署完成后前往许可中心重新导入许可文件。

启动SuperMap iManager部署中心并访问，进入部署界面，点击开始部署。
选择产品，选择SuperMap GIS云套件，单击下一步按钮。
配置环境依赖项，基本配置项中包括Kubernetes配置、存储配置、镜像配置，您可以根据实际情况按需填写或修改默认值。高级选项中您可以进行Kubernetes节点亲和性和容忍度的配置，便于控制Pod如何在集群中进行调度，以满足您的资源需求和运行约束。配置完成后，单击下一步按钮。

3.1 基本配置

Kubernetes配置：您可以分别配置K8s Master节点的URL地址和启用/不开启服务网格。

Kubernetes Server地址默认填入https://kubernetes.default.svc，通常保持默认即可；如果由阿里云等公有云提供K8s环境，需填写实际K8s主节点的URL，您可使用命令“kubectl cluster-info”查看K8s集群信息获取，例如，https://192.168.17.110:6443。
存储配置：提供NFS Server和StorageClass两种方式来存储iManager数据。
- NFS Server：您需要在K8s的Node节点机器中安装NFS Client。NFS Server地址需填写您的NFS Server地址，支持填写IP或域名。NFS Server提供挂载的路径默认是根路径（/），请根据您安装的NFS情况来填写，如果使用SuperMap提供的NFS离线安装包安装NFS，则此处地址填写为：/opt/nfs_data。
- StorageClass：支持填写Ceph存储或Longhorn存储对应的StorageClass名称。
镜像配置：您可以填写iManager镜像仓库相关的配置，来拉取部署iManager所需镜像。

镜像仓库地址默认为阿里云仓库registry.cn-beijing.aliyuncs.com，使用外网时推荐该地址；如果您使用内网，仓库配置为<ip>:5000，<ip>是镜像仓库所在机器的IP。

镜像仓库命名空间默认为supermap，也可以自定义。

镜像拉取策略提供IfNotPresent、Always、Never 3种方式，分别表示“如果本地有可用镜像，使用本地镜像，否则从镜像仓库拉取”、“总是从镜像仓库拉取最新镜像”、“不从镜像仓库拉取镜像”，默认选择IfNotPresent。

镜像拉取的密钥名称用于拉取私有镜像时的身份认证，可填写image-pull-secret，如果您配置的是私有仓库，请参见常见问题解答（教程->附录->常见问题解答->问题6）。

3.2 高级选项

节点亲和性配置：您可以在节点调度模式为强制性调度和偏好性调度下分别配置。

强制性调度确保Pod必须在满足节点亲和性规则的节点上调度。标签设置中，您可以设置标签键（key）、操作符（operator）和标签值（values）。操作符可选择“In”（匹配标签键的值必须是提供的列表中的一个）、“NotIn”（匹配标签键的值不能是提供的列表中的任何一个）、“Exists”（匹配标签键必须存在，无论其值是什么）、“DoesNotExist”（匹配标签键必须不存在）、“Gt”（匹配标签键的值必须大于提供的值）或“Lt”（匹配标签键的值必须小于提供的值）。此外，您可以新增标签。

偏好性调度允许Pod在尽可能地满足节点亲和性规则的情况下进行调度，但不是必须的。您可以设置标签键（key）、操作符（operator）、标签值（values）和权重（weight），支持配置多个标签值并用“;”分隔。此外，您可以新增标签，也可添加多组偏好性设置。
节点容忍度配置：通过设置节点的容忍度，使Pod可以在具有特定污点的节点上调度。

您可以设置标签键（key）、操作符（operator）、标签值（values）和策略（effect）。操作符可选择“Equal”（相等）或“Exists”（存在），策略中可选择“NoSchedule”（不可调度）、“PreferNoSchedule”（偏好不调度）或“NoExecute”（移除不符规则的Pod）。此外，您可以新增标签。

配置产品，基本配置项中包括Ingress配置、访问入口配置、数据库配置，您可以根据实际情况按需填写或修改默认值。高级选项中您可以根据您的需求，选择启用/不开启多种内置的服务能力，包括：几何服务、文件管理器、系统监控服务、日志收割服务、iPortal相关的服务等，并支持配置外部的许可中心、消息通知服务和用户中心等服务。配置完成后，单击下一步按钮。

4.1 基本配置

Ingress配置：启用Ingress控制器后您可以进行域名设置，将提供ClusterIP和LoadBalancer两种服务类型，默认选择ClusterIP，如果由阿里云等公有云提供K8s环境则选择LoadBalancer。域名映射的Kubernetes节点IP，如果您选择ClusterIP类型或需要配置访问入口域名时时必填，选择LoadBalancer类型时选填，默认使用第一个K8s节点IP。
访问入口配置：启用Ingress控制器后您才可使用入口域名，支持自行修改外部访问GIS云套件服务的IP，建议填写K8s Master节点IP（或代理IP）/云厂商弹性公网IP，您还可以指定HTTP或HTTPS访问协议并配置其外部端口等，具体请参见GIS云套件管理（教程->站点管理->GIS云套件->GIS云套件管理->“配置”处）。
数据库配置：您可以启用配置外部数据库，如果不开启则默认使用系统提供的PostgreSQL数据库。

4.2 高级选项

系统时区：系统时区目录（/usr/share/zoneinfo/）下时区文件的相对路径，通常默认保持Asia/Shanghai，您可以按需修改，例如：America/New_York。
几何服务：是否启用启内置的几何服务
数据目录服务：是否启用内置的数据目录服务
文件管理器：是否启用内置文件管理器
hadoop yarn文件管理器：是否启用内置的Hadoop YARN文件管理器
流处理模型编辑器：是否启用内置的流处理模型编辑器
影像服务检索的Web客户端：是否启用内置影像服务检索的Web客户端
地理处理文件管理器：是否启用内置的处理自动化服务文件管理器
拷贝Oracle客户端并挂载的内置服务：是否启用该服务。如果要发布Oracle工作空间数据源，请启用该服务，来为GIS服务实例所使用
命令行和查看容器日志服务：是否启用内置容器管理中的相关能力

您可以按需选择是否开启系统监控服务（Prometheus)、日志收割服务和iPortal服务，并提供多项子功能服务，您可以按需选用以及配置外部服务。启用iPortal服务前需要您确保系统留有充足的资源。

如果许可中心、消息通知、网关的Redis、用户中心Keycloak及其数据库需要配置为外部的服务，您可以分别按需开启配置外部许可中心服务、配置外部消息通知服务（RabbitMQ）、配置外部Redis服务、配置外部用户中心（Keycloak服务）以及配置外部Keycloak数据库。配置时，请填写外部服务准确的主机名、端口、账号密码等信息。

创建管理员账户，填写管理员用户名及密码后，单击下一步按钮。
确认部署，在系统正式部署前，您可以返回前面步骤再次进行确认或修改信息，确认后单击一键部署按钮。

在系统部署过程中，您可以通过进度条掌握实时部署状态。最终部署结果中可能会有部分服务启动失败和部署失败：

部署成功但部分服务启动失败：“部署”界面将提醒您及时关注，可以进入iManager界面中的“基础服务”列表下找到对应的服务并尝试重新部署。
部署失败：您可以选择卸载重装或到前面配置步骤返回修改，重新配置后再尝试部署。

查看部署信息

在GIS云套件安装完成后，在部署中心->部署界面您可以查看产品名称、产品简介、产品版本、部署时间、访问地址，点击“访问地址”处即可跳转到登录界面，还可以一键卸载当前通过部署中心安装的GIS云套件。

进入部署中心->关于界面，您也可以了解已完成部署的GIS云套件的版本等信息。

注：

如果您忘记了管理员密码，可以重置密码。

GIS云套件部署完成后，建议您停用部署中心，停用/启用方法见部署中心->停用/启用部署中心。

配置许可

安装完成之后，还需要导入许可才能使用。这里以导入试用许可为例。

首先前往SuperMap官网申请试用许可或购买正式许可。

访问GIS云套件页面，在没有许可的情况下会自动跳转到许可中心（Web版）页面，点击激活更新，参照操作流程导入许可。

导入成功之后，在许可状态您就可以看到许可信息。

此时您就可以正常使用GIS云套件。