HOS技术支持帮助文档

# Docker容器环境

# 基础准备

# Docker基础服务安装

在所有服务器上安装：

离线安装方式（服务器无法访问外网）

#进入hos-base/docker安装包目录
#解压安装文件
tar zxf docker-20.10.23.tgz
tar zxf docker-rootless-extras-20.10.23.tgz

#拷贝文件
cp docker/* docker-rootless-extras/* docker-compose /usr/bin

#拷贝服务启动文件
cp service/* /usr/lib/systemd/system

#创建docker用户组
groupadd docker

#加载服务
systemctl daemon-reload

#启动服务
systemctl start docker

#自启动配置
systemctl enable docker

#验证
docker version

在线安装方式（服务器可以访问外网）：

1.安装docker
执行命令：curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun

启动 Docker：
$ sudo systemctl start docker

通过运行 hello-world 镜像来验证是否正确安装了 Docker Engine-Community：
$ sudo docker run hello-world

2.安装docker-compose
Compose 是用于定义和运行多容器 Docker 应用程序的工具。通过 Compose，您可以使用 YML 文件来配置应用程序需要的所有服务。然后，使用一个命令，就可以从 YML 文件配置中创建并启动所有服务。
下载地址：https://github.com/docker/compose/releases
执行命令下载：
$ sudo curl -L "https://github.com/docker/compose/releases/download/v2.2.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

配置可执行权限：
$ sudo chmod +x /usr/local/bin/docker-compose

创建软链接：
$ sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose

测试是否安装成功：
$ docker-compose version

# 基础服务安装

jdk、mysql、redis、minio、nginx、supervisor、keepalived等服务单机、集群环境的安装，请参考运维平台文档 (opens new window)。

# 数据库初始化

# 1.HOS门户系统

新建数据库：hos_portal，字符集：utf8mb4，排序规则：utf8mb4_0900_ai_ci，然后导入hos_portal_base_orgdict_all.sql。

# 2.HOS统一用户/统一认证系统

新建数据库：hos_open，字符集：utf8mb4，排序规则：utf8mb4_0900_ai_ci，然后导入hos_open_base_orgdict_all.sql。

注意：所有的访问地址都需要带http或https，例如：rear_server_url = 'http://192.168.1.1:8001/api'

# 1.更新应用表的服务地址字段
UPDATE hos_system_app SET rear_server_url = '统一用户访问地址/api' WHERE id = '154611b4c12878ac8f6434f935ea6157';
UPDATE hos_system_app SET access_url = '门户系统访问地址', rear_server_url = '门户系统访问地址/api' WHERE id = '1009852153d621a680d5886cde2311f9';

# 2.更新应用认证管理表的回调地址字段
UPDATE hos_iam_auth_oauth2 SET redirect_urls = '统一用户访问地址/oauth/redirect/hos' WHERE id = 'aa47df7b2bf2ca6af0abff3c05dde2d1';
UPDATE hos_iam_auth_oauth2 SET redirect_urls = '门户系统访问地址/oauth/redirect/hos' WHERE id = 'bb764cfa411dd87c3e902c1bae15de94';

# 3.更新openapi接口信息表的url字段
UPDATE hos_openapi_info SET url = '统一用户访问地址/api/openApi/uum/account/pull-account' WHERE id = '2e5875a488431eb03578e4fe2c111111';
UPDATE hos_openapi_info SET url = '统一用户访问地址/api/openApi/uum/role/pullRole' WHERE id = '2e5875a488431eb03578e4fe2c222222';
UPDATE hos_openapi_info SET url = '统一用户访问地址/api/openApi/uum/postRole/pullPostRole' WHERE id = '2e5875a488431eb03578e4fe2c333333';
UPDATE hos_openapi_info SET url = '统一用户访问地址/api/openApi/uum/resources/pull' WHERE id = '2e5875a488431eb03578e4fe2c444444';
UPDATE hos_openapi_info SET url = '统一用户访问地址/api/openApi/uum/scope-data/pull' WHERE id = '2e5875a488431eb03578e4fe2c555555';
UPDATE hos_openapi_info SET url = '统一用户访问地址/api/openApi/uum/interface/pull' WHERE id = '2e5875a488431eb03578e4fe2c666666';
UPDATE hos_openapi_info SET url = '统一用户访问地址/api/openApi/uum/page-preset/pull' WHERE id = '2e5875a488431eb03578e4fe2c777777';
UPDATE hos_openapi_info SET url = '统一用户访问地址/api/openApi/uum/perms/pull' WHERE id = '2e5875a488431eb03578e4fe2c888888';

# 4.更新系统配置的ip端口
UPDATE hos_iam_system_config SET value = '统一用户访问地址/api/openApi/license/state' WHERE id = 'ce887ad7613c7bcfbabc4ba93f402371';
UPDATE hos_iam_system_config SET value = '统一用户访问地址/lisenceInstall' WHERE id = 'cy587ad7613c7bcfbabc4ba93f403321';
UPDATE hos_iam_system_config SET value = '门户系统访问地址/api/openApi/license/state' WHERE id = '9fa39d98a5a11fcf5c19e90c8f1174cb';
UPDATE hos_iam_system_config SET value = '门户系统访问地址/lisenceInstall' WHERE id = '222fab9f1c83f32e8dd92ddb09630d2f';

# 3.HOS任务调度平台

新建数据库：hos_xxl_job，字符集：utf8mb4，排序规则：utf8mb4_0900_ai_ci，导入sql：init_xxl_job.sql。

# 单机环境安装

# 应用安装

# 统一门户后端服务

1.修改配置文件

修改安装包中的hos-portal/java/config/application-prod.yml：

修改数据库配置：

img_6.png

修改minio配置：

img_7.png

修改统一认证配置：

img_8.png

修改开放平台,认证中心地址，认证中心地址的ip与端口号与第三条中的 HOS-tokenUrl一致。开放平台地址的ip与端口号为对应开放平台的后端ip与端口号：

img_9.png

2.启动服务 编辑hos-portal/java/docker-compose.yml容器配置文件：

根据实际情况修改配置信息：

  • jvm配置：可以根据实际环境修改，也可以按照格式新增其他jvm参数。
  • 端口配置：此处左边8080为该服务的访问端口，根据实际规划修改；右侧80为容器内固定端口，不需要修改。

启动服务： docker-compose up -d

常用命令：

查看状态：
docker-compose ps
重启方式：
docker-compose restart

容器配置文件docker-compose.yml或者镜像如有修改，需要重新创建容器：
docker-compose down
docker-compose up -d

# 统一门户前端服务

修改nginx配置：编辑hos-protal/web/conf/hos-portal.conf，修改后端服务地址为实际环境地址，单机安装只需要填写单个地址。

修改容器配置文件hos-protal/web/docker-compose.yml，修改前端服务端口为实际规划端口。

启动前端容器服务： docker-compose up -d

常用命令：

查看状态：
docker-compose ps
重启方式：
docker-compose restart

容器配置文件docker-compose.yml或者镜像如有修改，需要重新创建容器：
docker-compose down
docker-compose up -d

# xxl-job任务调度平台

调度平台文件目录：hos-framework-job-admin/

启动服务：编辑hos-framework-job-admin/docker-compose.yml容器配置文件：

img_3.png

根据实际情况修改配置信息：

  • jvm配置：可以根据实际环境修改，也可以按照格式新增其他jvm参数。
  • 端口配置：此处左边8080为该服务的访问端口，根据实际规划修改；右侧80为容器内固定端口，不需要修改。

启动服务：

docker-compose up -d

常用命令：

查看状态：
docker-compose ps
重启方式：
docker-compose restart

容器配置文件docker-compose.yml或者镜像如有修改，需要重新创建容器：
docker-compose down
docker-compose up -d

访问验证： 访问服务器IP:端口，输入默认账号：admin/123456，登录成功即可。

img_4.png

# 统一认证后端服务

启动服务:编辑hos-authserver/java/docker-compose.yml容器配置文件：

img_9.png

根据实际情况修改配置信息：

  • jvm配置：可以根据实际环境修改，也可以按照格式新增其他jvm参数。
  • 端口配置：此处左边8080为该服务的访问端口，根据实际规划修改；右侧80为容器内固定端口，不需要修改。

启动服务： docker-compose up -d

常用命令：

查看状态：
docker-compose ps
重启方式：
docker-compose restart

容器配置文件docker-compose.yml或者镜像如有修改，需要重新创建容器：
docker-compose down
docker-compose up -d

# 统一认证前端服务

修改nginx配置：编辑hos-authserver/web/conf/hos-authserver.conf，修改统一认证后端服务地址为实际环境地址，单机安装只需要填写单个地址即可：

img_10.png

修改容器配置文件hos-authserver/web/docker-compose.yml，修改前端服务端口为实际规划端口即可：

img_11.png

启动前端容器服务： docker-compose up -d

常用命令：

查看状态：
docker-compose ps
重启方式：
docker-compose restart

容器配置文件docker-compose.yml或者镜像如有修改，需要重新创建容器：
docker-compose down
docker-compose up -d

# 开放平台后端服务

启动服务：编辑hos-open-platform/java/docker-compose.yml容器服务配置文件：

img_19.png

根据实际情况修改配置信息：

  • jvm配置：可以根据实际环境修改，也可以按照格式新增其他jvm参数。
  • 端口配置：此处左边8080为该服务的访问端口，根据实际规划修改；右侧80为容器内固定端口，不需要修改。

启动服务： docker-compose up -d

常用命令：

查看状态：
docker-compose ps
重启方式：
docker-compose restart

容器配置文件docker-compose.yml或者镜像如有修改，需要重新创建容器：
docker-compose down
docker-compose up -d

# 开放平台前端服务

修改nginx配置：编辑hos-open-platform/web/conf/hos-open-platform.conf，修改开放平台后端服务地址为实际环境地址，单机安装只需要填写单个地址即可：

img_20.png

修改容器配置文件hos-open-platform/web/docker-compose.yml，修改前端服务端口为实际规划端口即可：

img_21.png

启动前端容器服务： docker-compose up -d

常用命令：

查看状态：
docker-compose ps
重启方式：
docker-compose restart

容器配置文件docker-compose.yml或者镜像如有修改，需要重新创建容器：
docker-compose down
docker-compose up -d

# 服务访问验证

访问开放平台前端服务，使用默认账号admin/111111可以正常登录即可。

img_22.png

img_23.png

# 集群环境安装

# 应用安装

# 统一门户后端服务

在所有后端服务器上安装：

1.修改配置文件

修改安装包中的hos-portal/java/config/application-prod.yml：

修改数据库配置：

img_6.png

修改minio配置：

img_7.png

修改统一认证配置：

img_8.png

修改开放平台,认证中心地址，认证中心地址的ip与端口号与第三条中的 HOS-tokenUrl一致。开放平台地址的ip与端口号为对应开放平台的后端ip与端口号：

img_9.png

2.启动服务

编辑hos-portal/java/docker-compose.yml容器配置文件：

根据实际情况修改配置信息：

  • jvm配置：可以根据实际环境修改，也可以按照格式新增其他jvm参数。
  • 端口配置：左侧为该服务的访问端口，根据实际规划修改；右侧80为容器内固定端口，不需要修改。

启动服务：

docker-compose up -d

常用命令：
查看状态：
docker-compose ps
重启方式：
docker-compose restart

容器配置文件docker-compose.yml或者镜像如有修改，需要重新创建容器：
docker-compose down
docker-compose up -d

# 统一门户前端服务

在所有前端服务器上安装： 修改nginx配置：编辑hos-portal/web/conf/hos-portal.conf： 修改后端服务地址为实际环境地址，单机安装只需要填写单个地址即可。

修改容器配置文件hos-portal/web/docker-compose.yml： 修改前端服务端口为实际规划端口即可。

启动前端容器服务：

docker-compose up -d

常用命令：
查看状态：
docker-compose ps
重启方式：
docker-compose restart

容器配置文件docker-compose.yml或者镜像如有修改，需要重新创建容器：
docker-compose down
docker-compose up -d

# xxl-job任务调度平台

在所有后端服务器上安装：

调度平台文件目录：hos-framework-job-admin/

1.修改配置文件 编辑hos-framework-job-admin/config/application-prod.yml配置文件，根据实际配置修改mysql地址、库名、账号密码信息：

img_28.png

2.启动服务 编辑hos-framework-job-admin/docker-compose.yml容器配置文件：

img_29.png

根据实际情况修改配置信息：

  • jvm配置：可以根据实际环境修改，也可以按照格式新增其他jvm参数。
  • 端口配置：此处左边8080为该服务的访问端口，根据实际规划修改；右侧80为容器内固定端口，不需要修改。

启动服务：

docker-compose up -d

常用命令：
查看状态：
docker-compose ps
重启方式：
docker-compose restart

容器配置文件docker-compose.yml或者镜像如有修改，需要重新创建容器：
docker-compose down
docker-compose up -d

访问验证： 访问服务器IP:端口，输入默认账号：admin/123456，登录成功即可。

# 统一认证后端服务

在所有后端服务器上安装：

1.修改配置文件

根据实际情况修改hos-authserver/java/config/application-prod.yml的配置：

修改数据库配置(使用hos_open)：

img_30.png

修改redis配置:

img_31.png

修改minIO配置:

img_32.png

修改平台类型:

img_33.png

2.启动服务

编辑hos-authserver/java/docker-compose.yml容器配置文件：

img_34.png

根据实际情况修改配置信息：

  • jvm配置：可以根据实际环境修改，也可以按照格式新增其他jvm参数。
  • 端口配置：此处左边8080为该服务的访问端口，根据实际规划修改；右侧80为容器内固定端口，不需要修改。

启动服务：

docker-compose up -d

常用命令：
查看状态：
docker-compose ps
重启方式：
docker-compose restart

容器配置文件docker-compose.yml或者镜像如有修改，需要重新创建容器：
docker-compose down
docker-compose up -d

# 统一认证前端服务

在所有前端服务器上安装： 修改nginx配置：编辑hos-authserver/web/conf/hos-authserver.conf： 修改统一认证后端服务地址为实际环境地址，单机安装只需要填写单个地址即可。

img_35.png

修改容器配置文件hos-authserver/web/docker-compose.yml： 修改前端服务端口为实际规划端口即可。

img_36.png

启动前端容器服务：

docker-compose up -d

常用命令：
查看状态：
docker-compose ps
重启方式：
docker-compose restart

容器配置文件docker-compose.yml或者镜像如有修改，需要重新创建容器：
docker-compose down
docker-compose up -d

# 开放平台后端服务

在所有后端服务器上安装：

1.修改配置文件

修改开放平台安装包中的hos-open-platform/java/config/application-prod.yml：

修改数据库配置：

img_37.png

修改redis配置：

img_38.png

修改工作流服务配置：

img_39.png

修改minio配置：

img_40.png

修改xxl-job配置:

img_41.png

修改统一认证配置：

img_42.png

配置服务总线地址：

img_43.png

2.启动服务 编辑hos-open-platform/java/docker-compose.yml容器服务配置文件：

img_44.png

根据实际情况修改配置信息：

  • jvm配置：可以根据实际环境修改，也可以按照格式新增其他jvm参数。
  • 端口配置：此处左边8080为该服务的访问端口，根据实际规划修改；右侧80为容器内固定端口，不需要修改。

启动服务：

docker-compose up -d

常用命令：
查看状态：
docker-compose ps
重启方式：
docker-compose restart

容器配置文件docker-compose.yml或者镜像如有修改，需要重新创建容器：
docker-compose down
docker-compose up -d

# 开放平台前端服务

在所有前端服务器上安装：

修改nginx配置：编辑hos-open-platform/web/conf/hos-open-platform.conf： 修改开放平台后端服务地址为实际环境地址，单机安装只需要填写单个地址即可。

img_45.png

修改容器配置文件hos-open-platform/web/docker-compose.yml： 修改前端服务端口为实际规划端口即可。

img_46.png

启动前端容器服务：

docker-compose up -d

常用命令：
查看状态：
docker-compose ps
重启方式：
docker-compose restart

容器配置文件docker-compose.yml或者镜像如有修改，需要重新创建容器：
docker-compose down
docker-compose up -d

# 服务访问验证

提示

系统需要许可授权激活后方可登录使用，参考：系统许可申请与激活

访问门户系统、统一用户前端地址： img.png

# 其他配置

← Windows系统环境 →