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)
|
4747e2f4
tangwang
embedding perform...
|
15
|
# --model-name NAME 模型名称(默认读取 embeddings/config.py)
|
40f1e391
tangwang
cnclip
|
16
17
18
19
20
|
# --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
|
# 颜色定义
RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
BLUE='\033[0;34m'
NC='\033[0m' # No Color
|
4747e2f4
tangwang
embedding perform...
|
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
|
# 项目路径(以仓库实际路径为准,避免写死 /data/tw/...)
PROJECT_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
resolve_default_model_name() {
local python_bin
local resolved_model_name
for python_bin in python3 python; do
if command -v "${python_bin}" >/dev/null 2>&1; then
if resolved_model_name="$(PYTHONPATH="${PROJECT_ROOT}${PYTHONPATH:+:${PYTHONPATH}}" "${python_bin}" -c "from embeddings.config import CONFIG; print(CONFIG.CLIP_AS_SERVICE_MODEL_NAME)" 2>/dev/null)"; then
if [ -n "${resolved_model_name}" ]; then
echo "${resolved_model_name}"
return 0
fi
fi
fi
done
echo "CN-CLIP/ViT-L-14"
}
|
40f1e391
tangwang
cnclip
|
53
54
|
# 默认配置
DEFAULT_PORT=51000
|
07cf5a93
tangwang
START_EMBEDDING=...
|
55
|
DEFAULT_DEVICE="cuda"
|
4747e2f4
tangwang
embedding perform...
|
56
|
DEFAULT_MODEL_NAME="$(resolve_default_model_name)"
|
40f1e391
tangwang
cnclip
|
57
58
|
DEFAULT_REPLICAS=1 # 副本数
|
40f1e391
tangwang
cnclip
|
59
60
|
CLIP_SERVER_DIR="${PROJECT_ROOT}/third-party/clip-as-service/server"
LOG_DIR="${PROJECT_ROOT}/logs"
|
af7ee060
tangwang
service_ctl 简化为“显...
|
61
|
PID_FILE="${LOG_DIR}/cnclip.pid"
|
28e57bb1
tangwang
日志体系优化
|
62
63
64
|
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
|
65
66
67
68
69
70
71
72
|
# 帮助信息
show_help() {
echo "CN-CLIP 图像编码服务启动脚本(增强版)"
echo ""
echo "用法: $0 [选项]"
echo ""
echo "选项:"
|
af7ee060
tangwang
service_ctl 简化为“显...
|
73
|
echo " --port PORT 服务端口(默认:${CNCLIP_PORT:-${DEFAULT_PORT}})"
|
07cf5a93
tangwang
START_EMBEDDING=...
|
74
|
echo " --device DEVICE 设备类型:cuda 或 cpu(默认:cuda)"
|
40f1e391
tangwang
cnclip
|
75
76
77
78
79
80
|
echo " --model-name NAME 模型名称(默认:${DEFAULT_MODEL_NAME})"
echo " --replicas NUM 副本数(默认:${DEFAULT_REPLICAS})"
echo " --help 显示此帮助信息"
echo ""
echo "示例:"
echo " $0 # 使用默认配置启动"
|
07cf5a93
tangwang
START_EMBEDDING=...
|
81
82
|
echo " $0 --port 52000 --device cuda # 指定 CUDA 模式,端口 52000"
echo " $0 --port 52000 --device cpu # 显式使用 CPU 模式"
|
4747e2f4
tangwang
embedding perform...
|
83
|
echo " $0 --model-name CN-CLIP/ViT-L-14 # 临时覆盖模型"
|
40f1e391
tangwang
cnclip
|
84
85
|
echo " $0 --replicas 2 # 启动2个副本(需8-10GB显存)"
echo ""
|
4747e2f4
tangwang
embedding perform...
|
86
87
88
89
|
echo "说明:"
echo " - 默认模型取自 embeddings/config.py 的 CLIP_AS_SERVICE_MODEL_NAME"
echo " - 也可通过环境变量 CNCLIP_MODEL_NAME 覆盖,再由 --model-name 最终覆盖"
echo ""
|
40f1e391
tangwang
cnclip
|
90
|
echo "支持的模型:"
|
4747e2f4
tangwang
embedding perform...
|
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
|
local supported_models=(
"CN-CLIP/ViT-B-16|基础版本,速度快"
"CN-CLIP/ViT-L-14|平衡版本"
"CN-CLIP/ViT-L-14-336|高分辨率版本"
"CN-CLIP/ViT-H-14|大型版本,精度高"
"CN-CLIP/RN50|ResNet-50 版本"
)
local item model desc suffix
for item in "${supported_models[@]}"; do
model="${item%%|*}"
desc="${item#*|}"
suffix=""
if [ "${model}" = "${DEFAULT_MODEL_NAME}" ]; then
suffix="(当前默认)"
fi
echo " - ${model} ${desc}${suffix}"
done
|
40f1e391
tangwang
cnclip
|
108
109
110
|
}
# 解析命令行参数
|
af7ee060
tangwang
service_ctl 简化为“显...
|
111
|
PORT="${CNCLIP_PORT:-${DEFAULT_PORT}}"
|
40f1e391
tangwang
cnclip
|
112
|
DEVICE=${DEFAULT_DEVICE}
|
4747e2f4
tangwang
embedding perform...
|
113
|
MODEL_NAME="${CNCLIP_MODEL_NAME:-${DEFAULT_MODEL_NAME}}"
|
40f1e391
tangwang
cnclip
|
114
115
116
117
118
119
120
121
122
123
124
125
|
REPLICAS=${DEFAULT_REPLICAS}
while [[ $# -gt 0 ]]; do
case $1 in
--port)
PORT="$2"
shift 2
;;
--device)
DEVICE="$2"
shift 2
;;
|
40f1e391
tangwang
cnclip
|
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
|
--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
日志体系优化
|
166
167
168
169
170
|
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
|
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
|
# 检查是否已经有服务在运行
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=...
|
193
|
# 使用 CN-CLIP 专用环境(避免与主项目依赖冲突)
|
cc11ae04
tangwang
cnclip
|
194
195
196
197
198
|
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
|
199
|
else
|
07cf5a93
tangwang
START_EMBEDDING=...
|
200
201
202
|
echo -e "${RED}错误: 未找到 CN-CLIP 专用环境 ${CNCLIP_VENV}${NC}"
echo -e "${YELLOW}请先执行: ./scripts/setup_cnclip_venv.sh${NC}"
exit 1
|
40f1e391
tangwang
cnclip
|
203
204
|
fi
|
cc11ae04
tangwang
cnclip
|
205
|
# 检查 Python 依赖(CN-CLIP 服务端需要 cn_clip 与 clip_server)
|
40f1e391
tangwang
cnclip
|
206
207
208
|
echo -e "${BLUE}检查 Python 依赖...${NC}"
python -c "import cn_clip" 2>/dev/null || {
echo -e "${RED}错误: cn_clip 未安装${NC}"
|
07cf5a93
tangwang
START_EMBEDDING=...
|
209
|
echo -e "${YELLOW}请重建专用环境: ./scripts/setup_cnclip_venv.sh${NC}"
|
40f1e391
tangwang
cnclip
|
210
211
212
|
exit 1
}
|
cc11ae04
tangwang
cnclip
|
213
|
# clip_server 通过 PYTHONPATH 加载(见下方启动命令),此处仅做可导入性检查
|
af7ee060
tangwang
service_ctl 简化为“显...
|
214
|
export PYTHONPATH="${CLIP_SERVER_DIR}${PYTHONPATH:+:${PYTHONPATH}}"
|
cc11ae04
tangwang
cnclip
|
215
216
|
python -c "import clip_server" 2>/dev/null || {
echo -e "${RED}错误: clip_server 不可用${NC}"
|
07cf5a93
tangwang
START_EMBEDDING=...
|
217
|
echo -e "${YELLOW}请重建专用环境: ./scripts/setup_cnclip_venv.sh${NC}"
|
40f1e391
tangwang
cnclip
|
218
219
220
|
exit 1
}
|
cc11ae04
tangwang
cnclip
|
221
|
echo -e "${GREEN}✓ 所有依赖已就绪${NC}"
|
40f1e391
tangwang
cnclip
|
222
223
|
echo ""
|
cc11ae04
tangwang
cnclip
|
224
|
# 自动检测设备(可通过环境变量 CNCLIP_DEVICE 指定,供 service_ctl/restart 使用)
|
07cf5a93
tangwang
START_EMBEDDING=...
|
225
226
227
228
229
230
231
232
233
234
235
236
237
|
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
|
238
|
fi
|
07cf5a93
tangwang
START_EMBEDDING=...
|
239
|
echo -e "${GREEN}✓ 设备: cuda(严格 GPU 模式,失败不降级)${NC}"
|
40f1e391
tangwang
cnclip
|
240
|
else
|
07cf5a93
tangwang
START_EMBEDDING=...
|
241
|
echo -e "${YELLOW}✓ 设备: cpu(显式配置)${NC}"
|
40f1e391
tangwang
cnclip
|
242
243
244
245
246
247
248
249
250
|
fi
# 显示配置信息
echo -e "${BLUE}服务配置:${NC}"
echo " 模型名称: ${MODEL_NAME}"
echo " 服务端口: ${PORT}"
echo " 协议: gRPC (默认,官方推荐)"
echo " 其他参数: 使用官方默认值"
echo " 副本数: ${REPLICAS}"
|
28e57bb1
tangwang
日志体系优化
|
251
|
echo " 日志文件: ${LOG_LINK}"
|
40f1e391
tangwang
cnclip
|
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
|
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 简化为“显...
|
268
|
export PYTHONPATH="${CLIP_SERVER_DIR}${PYTHONPATH:+:${PYTHONPATH}}"
|
40f1e391
tangwang
cnclip
|
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
|
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=...
|
284
|
# 生成新的配置文件(使用官方默认配置,显式传入 device)
|
40f1e391
tangwang
cnclip
|
285
286
287
288
289
290
291
292
293
294
295
|
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
|
296
|
device: '${DEVICE}'
|
40f1e391
tangwang
cnclip
|
297
298
299
300
301
302
303
304
305
|
metas:
py_modules:
- clip_server.executors.clip_torch
timeout_ready: 3000000
replicas: ${REPLICAS}
EOF
echo -e "${GREEN}✓ 已生成配置文件: ${TEMP_FLOW_FILE}${NC}"
|
28e57bb1
tangwang
日志体系优化
|
306
|
# 使用 nohup 在后台启动服务(日志按天分流)
|
40f1e391
tangwang
cnclip
|
307
|
cd "${CLIP_SERVER_DIR}"
|
28e57bb1
tangwang
日志体系优化
|
308
|
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
|
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
|
# 保存 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
日志体系优化
|
336
|
echo -e " tail -F ${LOG_LINK}"
|
40f1e391
tangwang
cnclip
|
337
338
339
340
341
342
343
344
345
|
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
日志体系优化
|
346
|
echo -e "${YELLOW}查看日志: tail -F ${LOG_LINK}${NC}"
|
40f1e391
tangwang
cnclip
|
347
348
349
350
351
352
353
|
else
echo -e "${RED}========================================${NC}"
echo -e "${RED}✗ 服务启动失败!${NC}"
echo -e "${RED}========================================${NC}"
echo ""
echo -e "请查看日志获取详细错误信息:"
|
28e57bb1
tangwang
日志体系优化
|
354
|
echo -e " tail -F ${LOG_LINK}"
|
40f1e391
tangwang
cnclip
|
355
356
357
358
|
echo ""
rm -f "${PID_FILE}"
exit 1
fi
|