{"componentChunkName":"component---src-templates-guides-js","path":"/zh/guides/InstallGISCloudSuiteOnK3S/","result":{"data":{"markdownRemark":{"html":"

安装GIS云套件-K3S环境

\n

用于在 Linux 单机环境下快速部署 GIS 云套件，GIS云套件基于 K3S 进行部署，关于 K3S 的更多信息请参考K3S官网。

\n

本文档所需文件均可在以下百度网盘中下载：

\n\n

前提条件

\n
    \n
  1. Linux 操作系统（建议使用 Ubuntu 18.04 或者 Ubuntu 16.04）
    2. \n
  2. 已经下载了 supermap-giscloudsuite-with-k3s-10.1.4-linux-x64.tar.gz 文件
    3. \n
  3. \n

    规格：

    \n\n
    4. \n
  4. \n

    镜像包准备（如果可以访问阿里云仓库，则忽略该步）

    \n\n
    5. \n
\n

镜像仓库安装

\n

开始之前，运行”sudo docker version”，确保Docker已成功安装，如果可以访问阿里云仓库，可以跳过此步

\n
    \n
  1. \n

    将镜像包放置在机器（可以是安装了Docker的任意机器）的任意目录，如：/home/，使用以下命令解压（若实际包名与示例中的包名不一致，在执行命令时请替换为实际包名）：

    \n
    tar -zxf supermap-giscloudsuite-registry-10.1.4-linux-x64.tar.gz
    \n
    2. \n
  2. \n

    进入解压后目录

    \n
    cd supermap-giscloudsuite-docker-images
    \n
    3. \n
  3. \n

    在当前目录执行以下命令，进行安装镜像库

    \n
    sudo chmod +x startup.sh  && sudo ./startup.sh
    \n
    4. \n
  4. \n

    验证镜像库安装是否成功

    \n
    sudo docker pull {ip}:5000/supermap/adminer:4.6.3
    \n

    其中{ip}为所在主机IP ，如果结果无error，则启动成功

    \n
    5. \n
\n

GIS云套件安装与使用

\n
\n

计算机需要开放values.yaml文件中“deploy_keycloak_port”（默认值32221）、“deploy_gateway_port”（默认值是32222）、“deploy_bslicense_ui_port”（默认值是32223）对应的端口，以及6443、8443、2049（使用NFS存储时开放）、8080、9100端口。如果您是使用阿里云ECS服务器，您需要将以上端口添加到安全组规则中。除此以外，还需要确保 3307 和 9183 端口不被占用。

\n
\n

以下所有命令均以管理员权限执行

\n
    \n
  1. \n

    将下载的文件解压（若实际包名与示例中的包名不一致，在执行命令时请替换为实际包名），得到”supermap-giscloudsuite-for-k3s”文件夹

    \n
    tar -zxf supermap-giscloudsuite-with-k3s-10.1.4-linux-x64.tar.gz
    \n
    2. \n
  2. \n

    进入 supermap-giscloudsuite-with-k3s 文件夹，执行：

    \n
    sudo  vi values.yaml
    \n

    根据实际情况修改 values.yaml 文件:

    \n
    \n

    注意：

    \n
      \n
    1. 符号”:“后面需留一个空格。
      2. \n
    2. 以下文件只能在启动GIS云套件前设置，如需再次修改，请修改完后重新执行安装脚本./startup.sh。文件带有默认值，修改时直接修改值即可，不需要移除任何配置。
      3. \n
    3. “必填”项需要根据实际情况填写或修改；“选填”项可以不修改，若“选填”项中有默认值，请保持默认值，不能删除。
      4. \n
    \n
    \n
     # 必填，GIS云套件镜像仓库的地址，用于拉取部署GIS云套件所需镜像。默认为阿里云仓库（外网使用时推荐该地址）：registry.cn-beijing.aliyuncs.com。\n # 内网仓库配置为<ip>:5000，<ip>为镜像仓库所在机器的IP（镜像仓库安装方法参照前文）。\n  deploy_registry: registry.cn-beijing.aliyuncs.com\n\n # 必填，外部可访问的K3s安装机器IP，启动时会再次确认，eg: 192.168.17.110。\n deploy_kubernetes_public_ip:\n\n # 必填，GIS云套件管理员账户名，用于登录GIS云套件，默认为user_admin，请自行更改。\n deploy_ispeco_user_name: user_admin\n\n # 必填，GIS云套件管理员密码，用于登录GIS云套件，默认为iserver，请自行更改。\n deploy_ispeco_password: iserver\n\n # 选填，您的NFS Server地址，用于存储GIS云套件数据，可以是IP或者域名，例如: 192.168.17.150。\n # 如果配置NFS Server,需要在机器中手动安装NFS Client。\n deploy_nfs_server:\n\n # 选填，NFS Server提供挂载的路径，默认根路径：/。如果不配置NFS，默认使用hostPath数据卷，位于本地/opt/giscloudsuite目录。\n deploy_nfs_path: /\n\n # 选填，K3s主节点URL，默认使用https://kubernetes.default.svc，保持默认即可。\n deploy_kubernetes_master_url: https://kubernetes.default.svc\n\n # 选填，镜像仓库的服务协议，取值范围：[http|https]，默认https。若使用SuperMap镜像包安装的镜像仓库，请配置为http。\n deploy_registry_protocol: https\n\n # 选填, 您的StorageClass名称，用于存储GIS云套件数据。StorageClass与NFS Server均用于GIS云套件数据存储，如果和NFS Server(deploy_nfs_server)同时存在，优先使用NFS Server作为GIS云套件数据存储。\n deploy_storage_class_name:\n\n # 选填，应用部署的K3s命名空间，可保持默认giscloudsuite，或根据实际需求自定义。\n deploy_namespace: giscloudsuite\n\n # 选填，GIS云套件服务协议，取值范围：[https|http]，默认http。\n deploy_service_protocol: http\n\n # 选填，镜像拉取策略，取值范围：[Always|Never|IfNotPresent]，默认为IfNotPresent。\n # Always：总是从镜像仓库拉取最新镜像；\n # Never：使用本地镜像，不从镜像仓库拉取镜像；\n # IfNotPresent：如果本地有可用镜像，使用本地镜像，否则从镜像仓库拉取。\n deploy_image_pull_policy: IfNotPresent\n\n # 选填，镜像拉取Secret，用于拉取私有镜像时进行身份认证。例如：image-pull-secret。配置Secret前，需在Kubernetes命名空间下创建与Secret同名的资源，详情请参见GIS云套件->附录->常见问题解答->问题12。\n deploy_image_pull_secret:\n\n # 选填，镜像仓库中存储镜像的命名空间名称，默认为supermap，支持用户自定义。\n deploy_image_namespace: supermap\n\n # 选填，Keycloak服务类型，取值范围：[NodePort|LoadBalancer]，通常保持默认即可。\n deploy_keycloak_service_type: NodePort\n\n # 选填，GIS云套件中单个服务的CPU分配，默认为1核。\n deploy_cpu_limit: 1\n\n # 选填，GIS云套件中单个服务的Memory分配，不能小于4Gi，默认为4Gi。\n deploy_memory_limit: 4Gi\n\n # 选填，指定GIS云套件中iserver_gisapplication的镜像tag。\n deploy_gis_app_tag: 10.1.4\n\n # 选填，指定GIS云套件中使用GIS镜像的tag。\n deploy_image_tag: 10.1.4\n\n # 选填，keycloak端口，自定义范围：30000-32767，不包括 31234，默认32221。如果自定义端口，注意不要与其他变量的端口相同。\n deploy_keycloak_port: 32221\n\n # 选填，管理UI端口，自定义范围：30000-32767，不包括 31234，默认32222。如果自定义端口，注意不要与其他变量的端口相同。\n deploy_gateway_port: 32222\n\n # 选填，许可中心端口，自定义范围：30000-32767，不包括 31234，默认32223。如果自定义端口，注意不要与其他变量的端口相同。\n deploy_bslicense_ui_port: 32223\n\n # 选填，是否禁用iPortal的相关服务，取值范围：[true|false]，默认true；\n # true：禁用iPortal相关服务；\n # false：不禁用iPortal相关服务。\n deploy_disable_iportal: true\n\n # 选填，许可中心是否禁用本地存储，取值范围：[true|false]，默认为 false。为 true 时必须配置deploy_nfs_server或default_storage_class_name；\n # true：许可中心不使用本地存储；\n # false：许可中心使用本地存储。\n deploy_disable_bslicense_local_volume: false\n\n # 选填，用于HBase性能优化，取值范围：[true|false]，默认false【如您没有使用HBase的需求，可以不做修改；如您需要优化内置HBase性能，请将该值设为true，详见GIS云套件->附录->常见问题解答->问题15】。\n deploy_disable_hbase_nfs_volume: false\n\n # 选填，GIS云套件配置域名时必填，GIS云套件域名映射的Kubernetes节点IP（即域名在DNS服务器上配置指向的IP）。默认使用第一个Kubernetes节点IP。\n deploy_domain_ip:\n\n # 选填，配置GIS云套件访问入口的域名，比如：imanager.iservergateway.com。不填使用IP加端口访问。\n deploy_gateway_domain:\n\n # 选填，GIS云套件访问入口域名对应的证书路径，只有配置了GIS云套件域名（deploy_gateway_domain），该变量才会生效。证书应当与values.yaml存放于同一目录下，填写时使用相对路径，比如：gateway/tls.crt。\n deploy_gateway_certificate_path:\n\n # 选填，GIS云套件访问入口域名对应证书的私钥路径，只有配置了GIS云套件域名（deploy_gateway_domain），该变量才会生效。私钥应当与values.yaml存放于同一目录下，填写时使用相对路径，比如:gateway/tls.key。\n deploy_gateway_private_key_path:\n\n # 选填，配置访问Keycloak的域名，比如：imanager.keycloak.com。不填使用IP加端口访问。\n deploy_keycloak_domain:\n\n # 选填，Keycloak安全中心域名对应的证书路径，只有配置了Keycloak安全中心域名（deploy_gateway_domain），该变量才会生效。证书应当与values.yaml存放于同一目录下，填写时使用相对路径，比如:keycloak/tls.crt。\n deploy_keycloak_certificate_path:\n\n # 选填，Keycloak安全中心域名对应证书的私钥路径，只有配置了Keycloak安全中心域名（deploy_gateway_domain），该变量才会生效。私钥应当与values.yaml存放于同一目录下，填写时使用相对路径，比如:keycloak/tls.key。\n deploy_keycloak_private_key_path:\n\n # 选填，设置系统时区。填写系统时区目录（/usr/share/zoneinfo/）下时区文件的相对路径，如Asia/Shanghai、America/New_York，默认为Asia/Shanghai。\n deploy_timezone: Asia/Shanghai\n\n # 选填，是否禁用metrics_server服务，metrics_server用于Kubernetes资源监控，取值范围：[true|false]。默认false；\n # true：禁用metrics_server服务；\n # false：开启metrics_server服务。\n deploy_disable_metrics_server: false
    \n

    修改完成后保存并退出：敲击键盘Esc键，命令行输入”:wq”后敲击回车键。

    \n
    3. \n
  3. \n

    安装

    \n

    下面命令均需要管理员权限执行

    \n
    chmod +x startup.sh && ./startup.sh
    \n

    startup.sh 脚本在执行过程中，会根据传入的仓库地址和协议，更新配置，以便正确的拉取镜像。中途还会确认使用的 ip，该 ip 可以被本机以外访问。

    \n

    安装完成后，可以通过 http://{ip}:32222 访问GIS云套件页面，通过 http://{ip}:32223 访问许可中心（Web版）页面。{ip}: 为安装 k3s 机器的 ip。如果deploy_service_protocol的值为https，则通过 https://{ip}:32222和https://{ip}:32223 访问。

    \n

    登录账号参见 values.yaml文件中配置的GIS云套件管理员账户信息

    \n
    4. \n
  4. \n

    配置许可

    \n

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

    \n

    首先先去 SuperMap 官网申请试用许可。

    \n

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

    \n

    \"licensemanagement\"

    \n

    导入成功之后，在许可状态可以看见许可信息

    \n

    \"licensestatus\"

    \n

    安装完成之后就可以正常使用

    \n
    5. \n
\n

附录

\n
    \n
  1. \n

    添加或修改http仓库到K3S

    \n

    编辑”/var/lib/rancher/K3S/agent/etc/containerd/config.toml.tmpl”

    \n

    如果文件不存在，执行下面命令

    \n
    cp /var/lib/rancher/K3S/agent/etc/containerd/config.toml /var/lib/rancher/K3S/agent/etc/containerd/config.toml.tmpl
    \n

    找到”plugins.cri.registry”，根据实际情况修改（registry.ispeco.com 使用实际值替换）

    \n
    [plugins.cri.registry]\n [plugins.cri.registry.mirrors]\n   [plugins.cri.registry.mirrors."registry.ispeco.com"]\n     endpoint = ["http://registry.ispeco.com"]
    \n

    如果有多个仓库，可以继续添加”plugins.cri.registry.mirrors.xxx”，以192.168.17.150:5001仓库为例

    \n
    [plugins.cri.registry]\n [plugins.cri.registry.mirrors]\n   [plugins.cri.registry.mirrors."registry.ispeco.com"]\n     endpoint = ["http://registry.ispeco.com"]\n   [plugins.cri.registry.mirrors."192.168.17.150:5001"]\n     endpoint = ["http://192.168.17.150:5001"]
    \n

    修改之后重启 K3S

    \n
    systemctl restart K3S
    \n
    2. \n
  2. \n

    运行”shutdown.sh”文件可以删除GIS云套件

    \n
    chmod +x shutdown.sh && ./shutdown.sh
    \n

    如需彻底删除GIS云套件，请增加”-v”参数：

    \n
    chmod +x shutdown.sh && ./shutdown.sh -v
    \n
    3. \n
  3. \n

    卸载 K3S 环境

    \n

    在系统任务目录下执行下面命令卸载 K3S 环境，此命令会删除 K3S 相关的数据（拉取的镜像，配置等）

    \n
    K3S-uninstall.sh
    \n
    4. \n
  4. \n

    基础服务访问地址({ip}: 为安装 K3S 机器的 ip):

    \n\n\n \n \n\n\n \n \n\n\n \n \n\n
    服务地址
    GIS云套件http://{ip}:32222 或 https://{ip}:32222
    许可中心http://{ip}:32223 或 https://{ip}:32223
    \n
    5. \n
","frontmatter":{"title":"入门","next":null,"prev":null},"fields":{"path":"content/guides/InstallGISCloudSuiteOnK3S.zh.md","slug":"/zh/guides/InstallGISCloudSuiteOnK3S/","langKey":"zh"}}},"pageContext":{"slug":"/zh/guides/InstallGISCloudSuiteOnK3S/"}}}