服务实例管理

使用说明

服务实例是服务器上的具体的GIS服务。在SuperMap中，一个GIS服务对应一个服务实例，服务实例用于接收和处理客户端请求，实现一定的GIS功能，并将响应结果返回给客户端。

GIS云套件支持对服务实例进行管理，包括查看服务实例详情、对服务实例批量授权、编辑服务实例配置、指定服务实例运行的服务节点等。

功能入口

  • 左侧导航栏->服务管理->服务实例->服务实例列表；
  • 左侧导航栏->服务管理->服务实例->服务实例列表->单击列表内某个服务实例的名称->该实例的服务实例详情页面；

操作说明

下文将分别从服务列表页面与服务详情页面，对服务实例管理功能进行介绍。

服务列表页面

进入服务实例列表页面，如下图所示：

serviceinstancelist

  1. 服务实例过滤功能，可通过数据源类型、服务实例所在服务节点、服务实例的服务类型、服务状态、关键字、服务所属标签筛选所需服务。点击重置清空筛选项。

  2. 重点功能包括：

  • 发布服务：点击进行服务发布，具体发布步骤请参见发布服务。

  • 启动：批量启动服务实例运行。

  • 停止：批量手动停止服务实例。

  • 批量授权：批量设置服务实例的访问权限。

    • 匿名用户可访问：不设置访问权限，所有访客均可访问服务实例。
    • 所有登录用户可访问：GIS云套件中的用户，登录后可访问服务实例。
    • 指定角色可访问：授权可访问的角色，关联该角色的用户登录后可访问服务实例。

    备注

    1. 访问权限的详细介绍请参见SuperMap iServer帮助文档。
    2. GIS云套件中用户与角色的介绍请参见安全相关介绍。

  • 开启动态化管理：批量开启服务实例的动态化管理。当全局配置开启了动态化管理配置且存在服务实例已关闭了动态化管理时，方可使用。

  • 关闭动态化管理：批量关闭服务实例的动态化管理。当全局配置开启了动态化管理配置时，方可使用。

  • 刷新：批量刷新服务实例。当数据源发生变化时，需要同步更新服务实例，可通过刷新功能完成，更新过程中服务不会中断。

  • 管理标签：批量管理选中服务实例的标签。可为服务实例添加已有的或新增标签，最多支持设置6个标签。

  • 删除：批量删除选中的服务实例（单击服务列表左侧小方框可选中/取消选中服务实例）。删除服务实例的同时，可选择同步删除服务实例对应的缓存数据，以节省存储空间。

  1. 服务实例列表中的具体功能包括：

  • 名称：服务实例名称，点击进入服务详情页面。点击名称右侧的小图标，可查看该实例所在服务节点，并对服务节点进行伸缩操作。

  • 别名：自定义服务实例别名。

  • 地址：服务实例地址，点击浏览iServer REST服务。

  • 副本数：服务实例副本数量，可通过指定服务节点增加或减少。

  • 状态：服务实例的状态，包括正常（已启动）、正常（已就绪）、正常（已停止）、异常和未检测几种状态。当全局配置开启了动态化管理，服务实例空闲时被主动销毁状态即为已就绪，再次访问或使用将延迟初始化。针对状态异常的服务实例，提供了异常自动告警和自动修复的能力。

    • 异常自动告警：默认情况下，每间隔30s进行一次异常检测，当服务实例连续检测出2次及以上的异常，就会触发自动告警机制，将告警信息发送到iManager报警历史页面；
    • 异常自动修复：默认情况下，每间隔30s进行一次异常检测，当服务实例连续检测出2次及以上的异常，将自动尝试重构该服务实例；当服务实例连续检测出8次及以上的异常，将自动尝试对该服务实例所在的服务节点进行重启。
    注意事项：

    服务实例自动告警与修复的相关参数支持设置，具体请前往iManager for Kubernetes 站点管理>GIS云套件站点>cloudsuite-dashboard-api服务>编辑。如果GIS云套件不由iManager创建而来，请前往Kubernetes Dashboard页面设置。参数说明如下：

    SERVICE_INSTANCE_REBUILD_ENABLED：是否开启服务实例检测异常后的自动修复机制，默认值为true；

    SERVICE_INSTANCE_ABNORMAL_THRESHOLD：设置当服务实例连续检测出多少次异常时，自动尝试服务实例的重构，默认值为2（次）；

    SERVICE_NODE_REBUILD_ENABLED：是否开启服务实例检测异常后对该服务实例所在的服务节点的自动重启机制，默认值为true；

    SERVICE_NODE_INSTANCE_ABNORMAL_THRESHOLD：设置当服务实例连续检测出多少次异常时，自动尝试对该服务实例所在的服务节点进行重启，默认值为8（次），可按需设置，建议设置值不少于8次；

    SERVICE_INSTANCE_ABNORMAL_ALERT_ENABLED：是否开启服务实例检测异常后的自动告警机制，默认值为true；

    SERVICE_INSTANCE_ABNORMAL_ALERT_THRESHOLD：设置当服务实例连续检测出多少次异常时，自动发送异常告警信息，默认值为2（次）；

    SERVICE_INSTANCE_STATUS_UPDATE_PERIOD：设置服务实例异常检测的间隔时间，默认值为30（秒）。

  • 授权：设置服务实例的访问权限。

  • 标签：服务实例对应被设置的标签。各服务实例最多支持设置6个标签，并且可直接删除已设标签。

  • 操作：

    • 指定服务节点：将服务实例调度到任意一个或多个（选择多个服务节点）服务节点上运行；也可新增服务节点，将服务实例调度到新的服务节点上，按需为服务节点分配许可（具体可参见服务节点创建中选择许可类型部分的介绍）。
    • 编辑：编辑服务实例配置。
    • 刷新：刷新服务实例。当数据源发生变化时，需要同步更新服务实例，可通过刷新功能完成，更新过程中服务不会中断。也可在服务节点的编排文件中加入环境变量，实现自动刷新，具体方法请参见附录->常见问题解答->问题7。
    • 停止/启动：手动停止正在运行中的服务实例或启动已停止的服务实例。
    • 清除缓存：清除该服务实例的地图瓦片。注意：针对发布的REST-地图服务且数据源不是瓦片类型的服务实例，才具备此功能。
    • 删除：删除服务实例。删除服务实例的同时，可选择同步删除该服务实例对应的缓存数据，以节省存储空间，如果该服务实例没有对应的缓存数据，则无需选择删除。

服务实例详情页面

进入服务实例详情页面，如下图所示：

serviceinstancedetails

服务实例详情页显示了服务实例的名称、地址、创建时间、服务类型、数据源类型以及数据源信息。数据源类型是数据库型工作空间（Oracle工作空间、PostgreSQL工作空间、DM工作空间）或MongoDB瓦片、HBase服务、PostGIS服务时，可对服务实例批量修改数据源配置。点击别名处的按钮可为服务实例设置别名。

您还可进行如下操作：

  • 服务配置：更改服务实例配置。

    • 是否允许编辑：若允许编辑，则访问者可更改服务配置。
    • 是否启用地图瓦片缓存：启用后将自动切分为地图瓦片，同时可对UGCV5缓存类型的瓦片进行重采样，默认开启。为提升地图服务访问出图效率，GIS云套件支持在地图出图时使用相同坐标系的瓦片缓存，但当请求的瓦片与已存在的瓦片在瓦片起始点、像素大小、比例尺、格式、透明情况等方面存在不一致时，瓦片缓存将无法使用。默认开启瓦片缓存重采样功能，通过对 iServer、iDesktopX 切图生成的 UGCV5瓦片（本地剖分）或出图时生成的含 *.sci 配置文件的 UGCV5瓦片缓存（本地剖分）按需进行重采样、拼接裁剪、格式转换并出图，以支持相关场景(详见iServer帮助文档->参数<cacheResamplingDisabled>)中瓦片缓存的使用。
    • 是否启用矢量瓦片缓存：启用后将自动切分为矢量瓦片。

  • 所在节点：查看承载服务实例运行的服务节点。

  • 服务授权：设置服务实例的访问权限。

通过点击修改数据源配置可进入修改数据源配置对话框。如下图所示，勾选应用到该数据源的所有服务实例可对数据源配置类型相同的服务实例进行批量修改，并可查看被应用的服务实例列表，点击确定完成修改。

updatedatasource

应用示例

影像服务管理

针对发布了类型为影像服务的服务实例，下文将详细介绍影像服务管理及各项配置。

在服务列表中，点击属于影像服务的实例名称，进入数据源是影像服务的服务实例详情页面。 除了上述在“服务实例详情页面”部分的功能以外，影像服务还提供了影像查询与检索能力，并支持对查询结果进行浏览，点击影像检索处的地址即可查询。详细介绍请参考SuperMap iServer在线帮助（请参见[开始->使用iServer->使用影像服务->查询和检索影像]）。

imageserviceinstancedetails

以存储影像集合的数据源是文件型数据源(UDBX)为例，具体可进行如下操作：

  • 影像集合：影像服务发布后，需要再通过添加影像集合的方式，为服务添加影像数据。

    a. 基础配置：可以对已有的影像服务通过添加影像集合的方式追加影像数据，还可以按需启用自动追加能力，监控影像数据目录并自动追加新增影像。详细介绍请参考SuperMap iServer在线帮助（请参见[开始->使用iServer->使用影像服务->添加影像集合]）。

    imagebasicconfig

    • 集合ID：用来在服务中唯一标识该影像集合。集合ID可以包含中文、英文字符、数字。
    • 标题：影像集合的标题，简短说明集合特征。
    • 卫星类型：影像集合所属卫星类型，可用来说明卫星信息。
    • 坐标参考（EPSG编码）：集合的坐标系，该集合下不同坐标系的影像都将动态投影为集合坐标系，坐标系通过EPSG编码指定，如：4326表示WGS 1984地理坐标系。集合的坐标参考默认值为：4326，即WGS 1984地理坐标系。如果“添加影像数据方式”为“已有镶嵌数据集”，该参数无效，集合的坐标系等于已有镶嵌数据集的坐标系。
    • 添加影像数据方式：集合中影像数据的来源，例如，影像来源于“影像数据目录”，表示将指定文件目录下的影像文件添加到集合。
    • 影像目录地址：指定影像数据目录的路径，支持本地路径和共享目录路径。
    • 文件类型：添加到集合中的影像文件类型，勾选对应的文件类型即可，支持多选。
    • 搜索子文件夹中的文件：开启后，支持添加影像目录中子文件夹中的影像。
    • 添加影像进程数：执行添加影像任务的进程数，默认为4。需要依据影像文件数量和机器资源合理设置。

    autoadditionalconfig

    • 启用自动追加：开启后，监控目录下的新增影像文件将自动添加到集合。“存储影像集合的数据源”是UDBX类型时不支持自动追加。
    • 监控目录列表：监控的影像数据目录路径，输入后添加。通常与“影像数据目录”保持一致，也可设置其他目录。
    • 间隔时间：从自动追加触发器启动时间点开始，间隔多长时间触发一次自动追加影像操作。

    otherconfig

    根据需要还可配置集合其他参数：

    • 影像集合的关键字：便于查询检索影像集合。
    • 数据使用许可协议：影像数据使用许可协议，应添加指向许可证文本的URL。
    • 允许编辑：开启，表示集合允许添加和删除影像。
    • 允许下载数据：开启，表示允许下载集合中的影像。
    • 数据提供者信息：配置数据提供者详细信息，可以通过“添加数据提供者信息”添加多个数据提供者。

    b. 风格配置：影像显示风格支持在集合中进行配置，集合中所有影像显示风格相同，影像集合静默切片和动态出图都将使用集合所配置的风格。

    styleconfig

    • 是否应用风格模板：开启/关闭风格模板。开启后，可导入本地影像风格模板。
    • 影像风格模板：点击“导入风格模板文件”，上传本地影像图层属性模板（.xml）文件。

    在“影像显示风格”区域，设置影像显示风格参数：

    • 显示方式：支持两种：单波段拉伸显示，只显示某一个指定波段；波段组合显示，指定三个波段分布对应 R、G、B颜色通道组合显示。
    • 波段组合方式：若是单波段拉伸显示，输入一个波段号；若是波段组合显示，指定 R、G、B颜色通道分布对应的波段号，例如：R1,G2,B3 表示 1.2.3波段组合显示。
    • 拉伸方式：拉伸设置对单波段拉伸显示和波段组合显示都适用。
    • 插值方式：影像显示时使用的插值算法。
    • 亮度：影像显示的亮度。数值范围为-100到100，增加亮度为正，降低亮度为负。
    • 对比度：影像显示的对比度。数值范围为-100到100，增加对比度为正，降低对比度为负。
    • 无值透明：无值是否透明显示，若勾选，表示透明显示无值。
    • 无值：影像的无值。影像为多波段时，指定R、G、B颜色通道对应波段的无值。
    • 背景值透明：背景值是否透明显示，若勾选，表示透明显示背景值。
    • 背景值：影像的背景值。影像为多波段时，指定R、G、B颜色通道对应波段的无值。
    • 高程数据类型：影像显示使用的高程数据类型。

    c. 瓦片配置：支持配置启用影像服务动态缓存和影像静默切片方案。详细介绍请参考SuperMap iServer在线帮助（请参见[开始->使用iServer->使用影像服务->配置影像服务动态缓存/配置影像服务静默切片]）。

    tileconfig

    • 启用动态缓存：启用动态缓存生效后，浏览该集合的影像数据时，将缓存动态生成的瓦片，再次浏览影像时，将复用缓存目录下的瓦片，提高响应效率；若没有开启该项，将不会缓存动态生成的瓦片。

    配置影像集合的瓦片方案，设置相关参数如下：

    • 瓦片访问层级范围：限制前端可请求的瓦片层级范围，若请求超出此范围，将访问不到瓦片。
    • 瓦片格式：瓦片的图片类型。
    • 瓦片大小：256*256像素尺寸。
    • DPI：96 dpi。
    • 瓦片是否背景透明：开启，表示瓦片背景透明。

    配置静默切片执行，设置相关参数如下：

    • 执行方式：静默切片有两种执行方式。立即执行，保存配置后立刻在后台执行切片操作；计划任务，保存配置后切片操作在每天指定的时间段内执行。
    • 切片层级范围：程序将对指定范围的层级生成瓦片。静默切片采用一种影像地图高效生成瓦片方案，优先生成“切片层级范围”中最大层级的瓦片，在基于此瓦片结果生成其他层级瓦片。
    • 切片进程数：后台执行切片任务的进程数，建议根据机器配置和机器空闲资源合理设置。

    d. 影像优化：优化影像服务管理，提升服务性能和质量。支持创建影像金字塔、计算统计数据、创建影像概视图。详细介绍请参考SuperMap iServer在线帮助（请参见[开始->使用iServer->使用影像服务->优化影像数据]）。

  • 后台任务：后台任务列表显示了影像服务的任务ID、集合ID、创建时间、结束时间、任务类型、进度和操作。在任务类型和进度处可点击对后台任务进行筛选，任务类型包括：静默切片、计算统计数据、创建影像金字塔、创建影像集合等；进度包括：成功、执行中、异常。在操作处，点击详细信息可查看影像任务日志。

backendjob

  • 服务配置：更改服务实例配置。

    • 是否允许编辑：若允许编辑，则访问者可更改服务配置。
    • 是否允许下载：若允许下载，则访问者可下载影像集合中的影像文件。
    • 存储影像集合的数据源：可指定影像集合存储在UDBX文件型数据源和PostGIS、PostgreSQL数据库型数据源。
    • 数据源文件路径：指定数据源文件的位置。
    • 瓦片存储类型：指定瓦片的存储类型，包括：原始、紧凑以及MongoDB。
    • 瓦片存储路径：指定缓存瓦片的存储位置。

serviceinstancedetails2

  • 所在节点：查看承载影像服务实例运行的服务节点。

  • 服务授权：设置影像服务实例的访问权限。

相关主题

服务管理简介

服务实例简介