跳到主要内容

TASK 安装

本文将引导您完成单机版 TASK 安装过程，TASK为ONES任务协作模块，支持单独安装在服务器上（见第1节）、也支持和ONES服务集成部署（见第2节）。

1. 单独安装​

当前ONES 新版本支持单独部署Task，安装方式如下

1.1 安装包下载​

一般选择最新版本，具体版本可由 ONES 工程师给出 安装包存放位置建议在/opt/pkg下，执行下列命令创建相应目录并下载安装包

mkdir -p /opt/pkg && cd /opt/pkg
curl --user 'task:sem2pristemp4FRAP' -O https://r.feixiang.work/private-0/task-installer-private-0-latest.tar.gz
tar -vxf task-installer-private-0-latest.tar.gz

1.2 修改配置文件​

具体安装包的路径需要根据解压出来的目录替换
后续安装好后如果需要修改配置的话，需要修改/opt/task/config/config.txt文件，不再是这个 config-init.txt

cd task-installer-private-x-xxxx
vi config-init.txt

#视情况修改以下配置
################################ ONES 主服务信息配置  ############################
#以下部分配置在安装完成后，如再次修改，需执行 task_ctl restart 重启Task服务。
ONES_SERVICE_HTTP_PROTOCOL=http        #ONES服务使用的协议，http或https
ONES_SERVICE_WS_PROTOCOL=ws            #对应http和https，如果协议为http则此参数为ws；如果为https则此参数为wss
ONES_SERVICE_PORT=30011                 #ONES服务访问端口(如果是域名访问则为空)
ONES_SERVICE_DOMAIN=120.79.224.181      #ONES服务访问地址，对应ONES服务中private.yaml文件中去掉协议的ip或域名


###Task访问ONES主服务时使用的URL配置。（注意填写的是Task 访问 ONES 的路径配置，这部分别填错位置了！）
ONES_BACKEND_SERVICE_HTTP_PROTOCOL='http'
ONES_BACKEND_SERVICE_DOMAIN='10.0.0.203'
ONES_BACKEND_SERVICE_PORT='30011'

1.3 执行安装​

过程会处理镜像，时间稍长请耐心等待

./task_installer install

当看到终端输出如下结果表示安装完成

>>> The Installation is Complete

1. You can use the following command to start task services
# task_ctl start

2. For more information about task control commands
# task_ctl for help

3. For more information about task installer commands
# ./task_installer for help

4. For upgrade, you must go to task-installer-xxx directory.
# ./task_installer upgrade

5. task services access address.

Following HTTP access is ready.
http://10.0.0.201:8080

If https config is correct, following HTTPS access should work without https certificate warning.
https://ones-task:8443

1.4 启动服务​

task_ctl 命令已经写入环境变量，注意如果服务器是从普通用户切换到 root 用户的话，注意使用 sudo 时加载 root 的环境变量文件（sudo su -）

task_ctl start

启动完成后等待一会执行状态查询

task_ctl status

输出为Task服务的访问地址

#Task Service Detecting:
#task-web status: Online at 10.0.0.203:8080
#task-api status: Online at 10.0.0.203:8080
#postgresql status: Online at task-internal:5432
#redis status: Online at task-internal:6379
#elasticsearch status: Online at task-internal:9200

1.5 接入 ONES​

在 TASK 服务的配置文件中获取 secret​

grep ONES_CLIENT_SECRET /opt/task/config/config.txt |awk -F \' '{print $2}'
#执行后回显即是所需的secret（可在部署时修改，只用作两个应用间通讯）

在 ONES 服务器上进行配置更新​

登录 ONES 服务器，进入当前运行中实例的安装目录,修改配置文件

ones-ai-k8s.sh
vim config/private.yaml

#修改如下配置（如果不存在对应配置，则自行在最后一行加入）

onesTaskAppSecret: xxxxxxxxxxxx    #上一步获取的secret
onesTaskBaseURL: http://10.0.0.203:8080 # ONES 访问TASK服务的地址，对应task_ctrl status命令中的HTTP访问地址

重启 ONES 服务​

注意：执行以下命令将造成 ONES 服务暂时不可用

make setup-ones

稍等片刻重启完成 ONES 服务将可以正常访问，TASK 模块配置完成

2 集成安装​

当前ONES 新版本支持集成部署Task，安装方式如下

第一步：进入 ones 服务器，运行脚本​

ones-ai-k8s.sh

第二步：配置文件追加参数，确保包含以下三个参数​

vi config/private.yaml
# 下面版本需替换为实际部署版本，具体请联系ONES工程师
taskAppImage: img.ones.pro/task/ones-task:v1.x.x
taskAppEnable: "true"
onesTaskBaseURL: "http://taskapp-service"

第三步：重启服务​

make setup-ones

3 验证​

  • 直接在页面访问 Task 模块，能正常访问则部署正常

4 故障排查​

4.1 身份认证错误​

到task容器中，查看报错信息

cat /opt/task/data/task-api/log/

出现身份认证错误时，需要在应用中心卸载掉Task再重新安装

如果上述方法都不能解决，请联系 ONES 工程师