上传程序包要求

最近更新时间:2019-07-30 17:22:31

目前使用云服务器部署的应用支持的程序包格式包括 jar 、tar.gz 和 zip。

  • jar: FatJar 格式的程序包,用户可以参考 如何打 FatJar 包
  • tar.gz 、zip : 压缩包中必须包含三个文件,确保文件名正确
    • start.sh:启动脚本
    • stop.sh:停止脚本
    • cmdline:用于检查应用进程是否存在,没有.sh后缀
文件类型 启动方式
jar 云服务器上的 agent 会使用jar -jar命令启动程序。
tar.gz 云服务器上的 agent 会解压压缩包,使用解压目录下的start.sh脚本启动应用程序。
zip 云服务器上的 agent 会解压压缩包,使用解压目录下的start.sh脚本启动应用程序。

start.sh / stop.sh / cmdline 说明

以一个 Python 应用的压缩包为示例,解压后的文件目录如下:

  • promotionService.py
  • start.sh
  • stop.sh
  • cmdline

start.sh 启动脚本内容如下:

#! /bin/bash

already_run=`ps -ef|grep "python promotion"|grep -v grep|wc -l`
if [ ${already_run} -ne 0 ];then
    echo "promotionService already Running!!!! Stop it first"
    exit -1
fi

nohup python promotionService.py 8093 &

stop.sh 停止脚本内容如下:

#!/bin/bash

pid=`ps -ef|grep "python promotion"|grep -v grep|awk '{print $2}'`
kill -SIGTERM $pid
echo "process ${pid} killed"

cmdline 检测进程脚本,agent 通过ps -ef | grep 'cmdline 内容'来检测进程是否存在,示例如下:

python promotion

cmdline 更多说明

如果启动应用是 Java 应用,启动脚本中通过java -jar xxx.jar来启动应用。在 cmdline 文件中使用完整的 Java 启动命令。例如启动脚本中包含如下启动命令:

java -Xms128m -Xmx512m -XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=512m -jar consumer-demo-0.0.1-SNAPSHOT.jar

那么在 cmdline 中内容为:

java -Xms128m -Xmx512m -XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=512m -jar consumer-demo-0.0.1-SNAPSHOT.jar

当应用启动后,agent 会在服务器上执行ps -ef | grep 'cmdline 内容'来检查进程是否存在。

注意:

如果没有 cmdline 文件或者 cmdline 文件内容不正确,在控制台上部署组的状态会显示为 "已停止",即使此时服务器上的应用已经运行起来(但是 TSF agent 无法获取应用进程状态)。

MacOS 系统压缩软件说明

对于 MacOS 系统的用户,使用系统自带压缩软件时,会在压缩包里面生成__MACOSX的临时目录,从而导致 agent 无法找到启停脚本。用户可以 下载 Keka 压缩软件,选择 zip 压缩格式,勾选【排除 Mac 资源文件文件】选项。将文件拖拽到 keka 界面上进行压缩,这种方式生成的压缩包没有__MACOSX的临时目录。