Blame view

scripts/start_cnclip_service.sh 10.5 KB
40f1e391   tangwang   cnclip
1
2
3
4
5
6
7
8
9
10
11
12
13
  #!/bin/bash
  
  ###############################################################################
  # CN-CLIP 图像编码服务启动脚本(增强版)
  #
  # 用途:
  #   启动 CN-CLIP 模型推理服务,用于图像和文本编码
  #
  # 使用方法:
  #   ./scripts/start_cnclip_service.sh [选项]
  #
  # 选项:
  #   --port PORT           服务端口(默认:51000)
07cf5a93   tangwang   START_EMBEDDING=...
14
  #   --device DEVICE       设备类型:cuda 或 cpu(默认:cuda)
40f1e391   tangwang   cnclip
15
16
17
18
19
20
  #   --model-name NAME     模型名称(默认:CN-CLIP/ViT-H-14)
  #   --replicas NUM        副本数(默认:1)
  #   --help                显示帮助信息
  #
  # 示例:
  #   ./scripts/start_cnclip_service.sh
07cf5a93   tangwang   START_EMBEDDING=...
21
  #   ./scripts/start_cnclip_service.sh --port 52000 --device cuda
40f1e391   tangwang   cnclip
22
23
24
  #
  ###############################################################################
  
af7ee060   tangwang   service_ctl 简化为“显...
25
  set -euo pipefail
40f1e391   tangwang   cnclip
26
27
28
29
30
31
32
33
34
35
  
  # 颜色定义
  RED='\033[0;31m'
  GREEN='\033[0;32m'
  YELLOW='\033[1;33m'
  BLUE='\033[0;34m'
  NC='\033[0m' # No Color
  
  # 默认配置
  DEFAULT_PORT=51000
07cf5a93   tangwang   START_EMBEDDING=...
36
  DEFAULT_DEVICE="cuda"
40f1e391   tangwang   cnclip
37
  DEFAULT_MODEL_NAME="CN-CLIP/ViT-H-14"
74cca190   tangwang   cnclip
38
  # DEFAULT_MODEL_NAME="CN-CLIP/ViT-L-14-336"
40f1e391   tangwang   cnclip
39
40
  DEFAULT_REPLICAS=1  # 副本数
  
a7920e17   tangwang   项目名称和部署路径修改
41
42
  # 项目路径(以仓库实际路径为准,避免写死 /data/tw/...)
  PROJECT_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
40f1e391   tangwang   cnclip
43
44
  CLIP_SERVER_DIR="${PROJECT_ROOT}/third-party/clip-as-service/server"
  LOG_DIR="${PROJECT_ROOT}/logs"
af7ee060   tangwang   service_ctl 简化为“显...
45
  PID_FILE="${LOG_DIR}/cnclip.pid"
28e57bb1   tangwang   日志体系优化
46
47
48
  LOG_LINK="${LOG_DIR}/cnclip.log"
  LOG_FILE="${LOG_DIR}/cnclip-$(date +%F).log"
  LOG_ROUTER_SCRIPT="${PROJECT_ROOT}/scripts/daily_log_router.sh"
40f1e391   tangwang   cnclip
49
50
51
52
53
54
55
56
  
  # 帮助信息
  show_help() {
      echo "CN-CLIP 图像编码服务启动脚本(增强版)"
      echo ""
      echo "用法: $0 [选项]"
      echo ""
      echo "选项:"
af7ee060   tangwang   service_ctl 简化为“显...
57
      echo "  --port PORT           服务端口(默认:${CNCLIP_PORT:-${DEFAULT_PORT}})"
07cf5a93   tangwang   START_EMBEDDING=...
58
      echo "  --device DEVICE       设备类型:cuda 或 cpu(默认:cuda)"
40f1e391   tangwang   cnclip
59
60
61
62
63
64
      echo "  --model-name NAME     模型名称(默认:${DEFAULT_MODEL_NAME})"
      echo "  --replicas NUM        副本数(默认:${DEFAULT_REPLICAS})"
      echo "  --help                显示此帮助信息"
      echo ""
      echo "示例:"
      echo "  $0                                          # 使用默认配置启动"
07cf5a93   tangwang   START_EMBEDDING=...
65
66
      echo "  $0 --port 52000 --device cuda               # 指定 CUDA 模式,端口 52000"
      echo "  $0 --port 52000 --device cpu                # 显式使用 CPU 模式"
40f1e391   tangwang   cnclip
67
68
69
70
71
      echo "  $0 --replicas 2                            # 启动2个副本(需8-10GB显存)"
      echo ""
      echo "支持的模型:"
      echo "  - CN-CLIP/ViT-B-16      基础版本,速度快"
      echo "  - CN-CLIP/ViT-L-14      平衡版本"
af7ee060   tangwang   service_ctl 简化为“显...
72
73
      echo "  - CN-CLIP/ViT-L-14-336  高分辨率版本"
      echo "  - CN-CLIP/ViT-H-14      大型版本,精度高(默认)"
40f1e391   tangwang   cnclip
74
75
76
77
      echo "  - CN-CLIP/RN50          ResNet-50 版本"
  }
  
  # 解析命令行参数
af7ee060   tangwang   service_ctl 简化为“显...
78
  PORT="${CNCLIP_PORT:-${DEFAULT_PORT}}"
40f1e391   tangwang   cnclip
79
  DEVICE=${DEFAULT_DEVICE}
40f1e391   tangwang   cnclip
80
81
82
83
84
85
86
87
88
89
90
91
92
  MODEL_NAME=${DEFAULT_MODEL_NAME}
  REPLICAS=${DEFAULT_REPLICAS}
  
  while [[ $# -gt 0 ]]; do
      case $1 in
          --port)
              PORT="$2"
              shift 2
              ;;
          --device)
              DEVICE="$2"
              shift 2
              ;;
40f1e391   tangwang   cnclip
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
          --model-name)
              MODEL_NAME="$2"
              shift 2
              ;;
          --replicas)
              REPLICAS="$2"
              shift 2
              ;;
          --help)
              show_help
              exit 0
              ;;
          *)
              echo -e "${RED}错误: 未知参数 $1${NC}"
              show_help
              exit 1
              ;;
      esac
  done
  
  # 检查环境
  echo -e "${BLUE}========================================${NC}"
  echo -e "${BLUE}CN-CLIP 服务启动脚本${NC}"
  echo -e "${BLUE}========================================${NC}"
  echo ""
  
  # 检查项目目录
  if [ ! -d "${PROJECT_ROOT}" ]; then
      echo -e "${RED}错误: 项目目录不存在: ${PROJECT_ROOT}${NC}"
      exit 1
  fi
  
  # 检查 CLIP 服务目录
  if [ ! -d "${CLIP_SERVER_DIR}" ]; then
      echo -e "${RED}错误: CLIP 服务目录不存在: ${CLIP_SERVER_DIR}${NC}"
      exit 1
  fi
  
  # 创建日志目录
  mkdir -p "${LOG_DIR}"
28e57bb1   tangwang   日志体系优化
133
134
135
136
137
  if [ ! -x "${LOG_ROUTER_SCRIPT}" ]; then
      echo -e "${RED}错误: 日志路由脚本不存在或不可执行: ${LOG_ROUTER_SCRIPT}${NC}"
      exit 1
  fi
  ln -sfn "$(basename "${LOG_FILE}")" "${LOG_LINK}"
40f1e391   tangwang   cnclip
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
  
  # 检查是否已经有服务在运行
  if [ -f "${PID_FILE}" ]; then
      OLD_PID=$(cat "${PID_FILE}")
      if ps -p ${OLD_PID} > /dev/null 2>&1; then
          echo -e "${YELLOW}警告: 服务已经在运行 (PID: ${OLD_PID})${NC}"
          echo -e "${YELLOW}请先运行 ./scripts/stop_cnclip_service.sh 停止服务${NC}"
          exit 1
      else
          echo -e "${YELLOW}清理旧的 PID 文件${NC}"
          rm -f "${PID_FILE}"
      fi
  fi
  
  # 检查端口是否被占用
  if lsof -Pi :${PORT} -sTCP:LISTEN -t >/dev/null 2>&1; then
      echo -e "${RED}错误: 端口 ${PORT} 已被占用${NC}"
      echo -e "${YELLOW}请检查是否有其他服务正在使用该端口${NC}"
      echo -e "${YELLOW}可以使用: lsof -i :${PORT} 查看占用情况${NC}"
      exit 1
  fi
  
07cf5a93   tangwang   START_EMBEDDING=...
160
  # 使用 CN-CLIP 专用环境(避免与主项目依赖冲突)
cc11ae04   tangwang   cnclip
161
162
163
164
165
  CNCLIP_VENV="${PROJECT_ROOT}/.venv-cnclip"
  if [ -x "${CNCLIP_VENV}/bin/python" ]; then
      export PATH="${CNCLIP_VENV}/bin:${PATH}"
      export VIRTUAL_ENV="${CNCLIP_VENV}"
      echo -e "${GREEN}✓ 使用 CN-CLIP 专用环境: .venv-cnclip${NC}"
40f1e391   tangwang   cnclip
166
  else
07cf5a93   tangwang   START_EMBEDDING=...
167
168
169
      echo -e "${RED}错误: 未找到 CN-CLIP 专用环境 ${CNCLIP_VENV}${NC}"
      echo -e "${YELLOW}请先执行: ./scripts/setup_cnclip_venv.sh${NC}"
      exit 1
40f1e391   tangwang   cnclip
170
171
  fi
  
cc11ae04   tangwang   cnclip
172
  # 检查 Python 依赖(CN-CLIP 服务端需要 cn_clip 与 clip_server)
40f1e391   tangwang   cnclip
173
174
175
  echo -e "${BLUE}检查 Python 依赖...${NC}"
  python -c "import cn_clip" 2>/dev/null || {
      echo -e "${RED}错误: cn_clip 未安装${NC}"
07cf5a93   tangwang   START_EMBEDDING=...
176
      echo -e "${YELLOW}请重建专用环境: ./scripts/setup_cnclip_venv.sh${NC}"
40f1e391   tangwang   cnclip
177
178
179
      exit 1
  }
  
cc11ae04   tangwang   cnclip
180
  # clip_server 通过 PYTHONPATH 加载(见下方启动命令),此处仅做可导入性检查
af7ee060   tangwang   service_ctl 简化为“显...
181
  export PYTHONPATH="${CLIP_SERVER_DIR}${PYTHONPATH:+:${PYTHONPATH}}"
cc11ae04   tangwang   cnclip
182
183
  python -c "import clip_server" 2>/dev/null || {
      echo -e "${RED}错误: clip_server 不可用${NC}"
07cf5a93   tangwang   START_EMBEDDING=...
184
      echo -e "${YELLOW}请重建专用环境: ./scripts/setup_cnclip_venv.sh${NC}"
40f1e391   tangwang   cnclip
185
186
187
      exit 1
  }
  
cc11ae04   tangwang   cnclip
188
  echo -e "${GREEN}✓ 所有依赖已就绪${NC}"
40f1e391   tangwang   cnclip
189
190
  echo ""
  
cc11ae04   tangwang   cnclip
191
  # 自动检测设备(可通过环境变量 CNCLIP_DEVICE 指定,供 service_ctl/restart 使用)
07cf5a93   tangwang   START_EMBEDDING=...
192
193
194
195
196
197
198
199
200
201
202
203
204
  if [ -n "${CNCLIP_DEVICE:-}" ]; then
      DEVICE="${CNCLIP_DEVICE}"
  fi
  
  DEVICE="$(echo "${DEVICE}" | tr '[:upper:]' '[:lower:]')"
  if [ "${DEVICE}" != "cuda" ] && [ "${DEVICE}" != "cpu" ]; then
      echo -e "${RED}错误: 不支持的 device=${DEVICE},仅支持 cuda/cpu${NC}"
      exit 1
  fi
  if [ "${DEVICE}" == "cuda" ]; then
      if ! command -v nvidia-smi &> /dev/null || ! nvidia-smi &> /dev/null; then
          echo -e "${RED}错误: 已配置 --device cuda,但未检测到可用 NVIDIA GPU;禁止自动降级到 CPU${NC}"
          exit 1
40f1e391   tangwang   cnclip
205
      fi
07cf5a93   tangwang   START_EMBEDDING=...
206
      echo -e "${GREEN}✓ 设备: cuda(严格 GPU 模式,失败不降级)${NC}"
40f1e391   tangwang   cnclip
207
  else
07cf5a93   tangwang   START_EMBEDDING=...
208
      echo -e "${YELLOW}✓ 设备: cpu(显式配置)${NC}"
40f1e391   tangwang   cnclip
209
210
211
212
213
214
215
216
217
  fi
  
  # 显示配置信息
  echo -e "${BLUE}服务配置:${NC}"
  echo "  模型名称:     ${MODEL_NAME}"
  echo "  服务端口:     ${PORT}"
  echo "  协议:         gRPC (默认,官方推荐)"
  echo "  其他参数:     使用官方默认值"
  echo "  副本数:       ${REPLICAS}"
28e57bb1   tangwang   日志体系优化
218
  echo "  日志文件:     ${LOG_LINK}"
40f1e391   tangwang   cnclip
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
  echo ""
  
  # 副本数显存警告
  if [ "${DEVICE}" == "cuda" ] && [ ${REPLICAS} -gt 1 ]; then
      ESTIMATED_MEMORY=$((REPLICAS * 5))
      echo -e "${YELLOW}⚠ 预计显存占用: ~${ESTIMATED_MEMORY}GB (${REPLICAS} 副本 × ~5GB/副本)${NC}"
      echo -e "${YELLOW}  请确保有足够的显存!${NC}"
      echo ""
  fi
  
  # 直接启动,不需要确认
  
  # 构建启动命令
  cd "${CLIP_SERVER_DIR}"
  
  # 设置环境变量
af7ee060   tangwang   service_ctl 简化为“显...
235
  export PYTHONPATH="${CLIP_SERVER_DIR}${PYTHONPATH:+:${PYTHONPATH}}"
40f1e391   tangwang   cnclip
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
  export NO_VERSION_CHECK=1  # 跳过版本检查
  
  # 启动服务
  echo -e "${BLUE}正在启动服务...${NC}"
  
  # 创建动态配置文件
  FLOW_FILE="${CLIP_SERVER_DIR}/torch-flow.yml"
  TEMP_FLOW_FILE="${CLIP_SERVER_DIR}/torch-flow-temp.yml"
  
  # 备份原配置文件
  if [ -f "${FLOW_FILE}" ] && [ ! -f "${FLOW_FILE}.original" ]; then
      cp "${FLOW_FILE}" "${FLOW_FILE}.original"
      echo -e "${YELLOW}已备份原配置文件: ${FLOW_FILE}.original${NC}"
  fi
  
07cf5a93   tangwang   START_EMBEDDING=...
251
  # 生成新的配置文件(使用官方默认配置,显式传入 device)
40f1e391   tangwang   cnclip
252
253
254
255
256
257
258
259
260
261
262
  cat > "${TEMP_FLOW_FILE}" << EOF
  jtype: Flow
  version: '1'
  with:
    port: ${PORT}
  executors:
    - name: clip_t
      uses:
        jtype: CLIPEncoder
        with:
          name: '${MODEL_NAME}'
cc11ae04   tangwang   cnclip
263
          device: '${DEVICE}'
40f1e391   tangwang   cnclip
264
265
266
267
268
269
270
271
272
        metas:
          py_modules:
            - clip_server.executors.clip_torch
      timeout_ready: 3000000
      replicas: ${REPLICAS}
  EOF
  
  echo -e "${GREEN}✓ 已生成配置文件: ${TEMP_FLOW_FILE}${NC}"
  
28e57bb1   tangwang   日志体系优化
273
  # 使用 nohup 在后台启动服务(日志按天分流)
40f1e391   tangwang   cnclip
274
  cd "${CLIP_SERVER_DIR}"
28e57bb1   tangwang   日志体系优化
275
  nohup bash -lc "exec python -m clip_server \"${TEMP_FLOW_FILE}\" > >(\"${LOG_ROUTER_SCRIPT}\" \"cnclip\" \"${LOG_DIR}\" \"${LOG_RETENTION_DAYS:-30}\") 2>&1" >/dev/null 2>&1 &
40f1e391   tangwang   cnclip
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
  
  # 保存 PID
  SERVICE_PID=$!
  echo ${SERVICE_PID} > "${PID_FILE}"
  
  # 等待服务启动
  echo -e "${YELLOW}等待服务启动...${NC}"
  sleep 5
  
  # 检查服务是否启动成功
  if ps -p ${SERVICE_PID} > /dev/null 2>&1; then
      echo -e "${GREEN}========================================${NC}"
      echo -e "${GREEN}✓ CN-CLIP 服务启动成功!${NC}"
      echo -e "${GREEN}========================================${NC}"
      echo ""
      echo -e "服务信息:"
      echo -e "  PID:          ${SERVICE_PID}"
      echo -e "  端口:         ${PORT}"
      echo -e "  模型:         ${MODEL_NAME}"
      echo -e "  设备:         ${DEVICE}"
      echo ""
      echo -e "测试服务 (使用 Python 客户端):"
      echo -e "  from clip_client import Client"
      echo -e "  c = Client('grpc://localhost:${PORT}')"
      echo -e "  r = c.encode(['测试文本'])"
      echo ""
      echo -e "查看日志:"
28e57bb1   tangwang   日志体系优化
303
      echo -e "  tail -F ${LOG_LINK}"
40f1e391   tangwang   cnclip
304
305
306
307
308
309
310
311
312
      echo ""
      echo -e "停止服务:"
      echo -e "  ./scripts/stop_cnclip_service.sh"
      echo ""
  
      # 等待服务完全就绪(gRPC 协议无法用 curl 检查,等待固定时间)
      echo -e "${YELLOW}等待模型加载完成(约30-60秒)...${NC}"
      sleep 30
      echo -e "${GREEN}✓ 服务已启动,请查看日志确认模型是否加载完成${NC}"
28e57bb1   tangwang   日志体系优化
313
      echo -e "${YELLOW}查看日志: tail -F ${LOG_LINK}${NC}"
40f1e391   tangwang   cnclip
314
315
316
317
318
319
320
  
  else
      echo -e "${RED}========================================${NC}"
      echo -e "${RED}✗ 服务启动失败!${NC}"
      echo -e "${RED}========================================${NC}"
      echo ""
      echo -e "请查看日志获取详细错误信息:"
28e57bb1   tangwang   日志体系优化
321
      echo -e "  tail -F ${LOG_LINK}"
40f1e391   tangwang   cnclip
322
323
324
325
      echo ""
      rm -f "${PID_FILE}"
      exit 1
  fi