Files
ssw-ontology/docker/entrypoint.sh
T
admin ac9bcec67c feat(entrypoint): 新增 EXTERNAL_PG=true 跳过自带 PG 模式
之前 entrypoint 硬启动自带 PG(监听 5432),用户即使 -e DATABASE_URL
指向外部 PG 也会跟自带 PG 冲突(端口冲突 + 不该白白启动 PG)。

新增模式:-e EXTERNAL_PG=true 跳过所有 PG 启动逻辑,直接 exec /app/server。
DATABASE_URL 由 ontology 二进制自己解析(Go loadConfig 读)。

适用场景:
- 连宿主已有 PG(如 localhost:15432/shangshu 的 jnpf-postgres)
- 连独立 PG 容器、外部云库
- 开发期 ontology 连自己起的 PG,容器内不重复跑

实测两种模式都通过:
- EXTERNAL_PG=true + DATABASE_URL=...  → 'mode=external-pg' + DATABASE_URL 被 ontology 读到
- 默认模式 -e PGDATA=/data/pgdata       → 'user-specified via -e' + postgres ready + healthy

镜像 digest: 待 push 后输出
2026-09-04 16:07:50 +08:00

100 lines
4.2 KiB
Bash
Executable File

#!/bin/sh
# 尚数网本体管理平台 · 单镜像 entrypoint
#
# 设计要点:
# 1. 用户挂 -v /host/x:/data 时: /data/pg -> PG 数据; /data/archive -> 文档
# 2. 不挂: PG 用匿名卷 (不持久化), archive 用镜像内自带目录
# 3. PG 用官方 docker-entrypoint.sh 初始化 (用户/库/权限都由它管)
# 4. ontology exec 成 PID 1 (接 SIGTERM 优雅退出), PG 在后台, trap 保证一起收
# 5. EXTERNAL_PG=true 跳过自带 PG,直接连 DATABASE_URL 指向的外部库
set -eu
# ----------------------------------------------------------------------------
# 0. 模式分支:EXTERNAL_PG=true 跳过所有 PG 启动逻辑
# ----------------------------------------------------------------------------
if [ "${EXTERNAL_PG:-false}" = "true" ]; then
echo "[entrypoint] mode=external-pg (DATABASE_URL=$DATABASE_URL)"
# archive 仍按 /data 挂载规则处理
if [ -d /data ] && [ -d /data/archive ]; then
rm -rf /app/archive
ln -sfn /data/archive /app/archive
echo "[entrypoint] archive -> /data/archive (mounted)"
else
mkdir -p /app/archive
echo "[entrypoint] archive -> /app/archive (ephemeral)"
fi
echo "[entrypoint] starting ontology on :${HTTP_PORT:-8081} (no local PG)..."
exec /app/server
fi
# ----------------------------------------------------------------------------
# 1. 数据目录决策(优先级:用户显式传 > /data/pg 挂载 > 默认匿名卷)
# ----------------------------------------------------------------------------
# 用户显式传 PGDATA(且不是 Dockerfile 默认值) -> 尊重用户,不被 /data/pg 覆盖
if [ -n "${PGDATA:-}" ] && [ "${PGDATA}" != "/var/lib/postgresql/data" ]; then
echo "[entrypoint] PGDATA=$PGDATA (user-specified via -e)"
# 典型场景:挂载 /data/pg 让 PG 数据持久化
elif [ -d /data ] && [ -d /data/pg ]; then
export PGDATA=/data/pg
echo "[entrypoint] PGDATA=/data/pg (mounted /data/pg)"
# 兜底:不挂任何卷,PG 用镜像内匿名卷(不持久化,重启数据丢)
else
export PGDATA=/var/lib/postgresql/data
echo "[entrypoint] PGDATA=/var/lib/postgresql/data (anonymous)"
fi
# /data/archive 存在 -> 软链到 /app/archive, 让 ontology 写入透明生效
if [ -d /data ] && [ -d /data/archive ]; then
rm -rf /app/archive
ln -sfn /data/archive /app/archive
echo "[entrypoint] archive -> /data/archive (mounted)"
else
mkdir -p /app/archive
echo "[entrypoint] archive -> /app/archive (ephemeral)"
fi
# ----------------------------------------------------------------------------
# 2. 启动 Postgres (用官方 entrypoint 完成 initdb/建用户/建库等)
# ----------------------------------------------------------------------------
echo "[entrypoint] starting postgres..."
/usr/local/bin/docker-entrypoint.sh postgres &
PG_PID=$!
# ----------------------------------------------------------------------------
# 3. 等 PG 就绪 (最多 60s)
# ----------------------------------------------------------------------------
echo "[entrypoint] waiting for postgres at 127.0.0.1:5432..."
READY=no
for i in $(seq 1 60); do
if pg_isready -h 127.0.0.1 -p 5432 \
-U "${POSTGRES_USER:-ssw}" \
-d "${POSTGRES_DB:-ssw-ontology}" -q 2>/dev/null; then
READY=yes
break
fi
sleep 1
done
if [ "$READY" != "yes" ]; then
echo "[entrypoint] FATAL: postgres not ready after 60s, dumping logs..."
kill -TERM "$PG_PID" 2>/dev/null || true
wait "$PG_PID" 2>/dev/null || true
exit 1
fi
echo "[entrypoint] postgres ready (db=${POSTGRES_DB:-ssw-ontology})"
# ----------------------------------------------------------------------------
# 4. trap: ontology 退出时, 顺手把 PG 也带走 (避免孤儿进程)
# ----------------------------------------------------------------------------
cleanup() {
echo "[entrypoint] stopping postgres (pid=$PG_PID)..."
kill -TERM "$PG_PID" 2>/dev/null || true
wait "$PG_PID" 2>/dev/null || true
}
trap cleanup EXIT TERM INT
# ----------------------------------------------------------------------------
# 5. 前台启动 ontology (exec -> 它就是 PID 1, 接收 docker stop 的 SIGTERM)
# ----------------------------------------------------------------------------
echo "[entrypoint] starting ontology on :${HTTP_PORT:-8081}..."
exec /app/server