Files
adminandClaude Code 8583b9f40b docs(docker): 构建镜像须带 --provenance=false --sbom=false
buildx 默认给镜像附一份 attestation manifest,阿里云私仓不认这个 manifest
class。本地 build 一切正常,push 才炸:

  error from registry: unknown manifest class for
  application/vnd.oci.empty.v1+json

v1.5.3 推镜像时实测踩到,重建后正常。Dockerfile 头部构建示例与 README
「本地构建镜像」两处都补上该 flag 并记下报错原文,避免下次照着注释敲命令
再踩一遍。

验证:按补好的命令重新 build + push 成功,digest 与已推送的 v1.5.3 一致
(sha256:4c1f1be8…),即该 flag 不改变镜像内容,只是去掉私仓不认的那份附件。

Co-Authored-By: Claude Code <[email protected]>
2026-10-17 12:40:09 +08:00

74 lines
3.4 KiB
Docker

# =============================================================================
# 尚数网本体管理平台 · 单镜像构建文件
#
# * 基础: 苏苏阿里云私仓 postgres:16-alpine (已缓存)
# * 内容: postgres + ontology 二进制 + entrypoint (二者同生命周期)
# * 默认: 端口 8081, 数据库名 ssw-ontology, 用户 ssw / 密码 ssw
#
# 构建 (版本号随 ldflags 注入二进制,页脚/MCP/API 可见):
# VERSION=$(git describe --tags --always --dirty)
# CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build \
# -ldflags "-s -w -X main.Version=${VERSION} -X main.Commit=$(git rev-parse --short HEAD) -X main.BuildTime=$(date -u +%Y-%m-%dT%H:%M:%SZ)" \
# -o bin/server-linux ./server
# docker build --provenance=false --sbom=false -t ssw-ontology:${VERSION} .
#
# ⚠️ --provenance=false --sbom=false 不可省(2026-10-17 实测):
# buildx 默认会给镜像附一份 attestation manifest,私仓不认这个 manifest
# class,本地 build 一切正常,push 才炸:
# error from registry: unknown manifest class for
# application/vnd.oci.empty.v1+json
# 两个 flag 一起关掉即可。
#
# 推到私仓 (可选):
# docker tag ssw-ontology:1.0.0 \
# crpi-yscq976uwza88qap.cn-shenzhen.personal.cr.aliyuncs.com/ssw188/ssw-ontology:1.0.0
# docker push crpi-yscq976uwza88qap.cn-shenzhen.personal.cr.aliyuncs.com/ssw188/ssw-ontology:1.0.0
#
# 直接跑 (无持久化, 仅试用):
# docker run --rm -p 8081:8081 ssw-ontology:1.0.0
#
# 持久化跑 (把 /data 挂到本地某目录, 自动分 pg/archive):
# mkdir -p ~/ssw-ontology-data/pg ~/ssw-ontology-data/archive
# docker run -d --name ssw-ontology \
# -p 8081:8081 \
# -v ~/ssw-ontology-data:/data \
# --restart unless-stopped \
# ssw-ontology:1.0.0
# =============================================================================
FROM crpi-yscq976uwza88qap.cn-shenzhen.personal.cr.aliyuncs.com/ssw188/postgres:16-alpine
# postgres:alpine 用的是 busybox wget, 可直接拿来做健康检查; 但补 CA 证书
# 是为了让 ontology 调 MiniMax/AI HTTPS 不被 TLS handshake 失败卡住.
RUN apk add --no-cache ca-certificates
# ontology 二进制: Go 静态链接, ~22MB, 无 libc 依赖 (Linux amd64)
COPY bin/server-linux /app/server
RUN chmod +x /app/server && mkdir -p /app/archive
# 单进程入口脚本: PG 后台 + 等就绪 + exec ontology 前台
COPY docker/entrypoint.sh /usr/local/bin/entrypoint.sh
RUN chmod +x /usr/local/bin/entrypoint.sh
# -----------------------------------------------------------------------------
# 默认环境变量 (用户可在 docker run -e 覆盖)
# -----------------------------------------------------------------------------
ENV HTTP_PORT=8081 \
POSTGRES_USER=ssw \
POSTGRES_PASSWORD=ssw \
POSTGRES_DB=ssw-ontology \
PGDATA=/var/lib/postgresql/data \
ARCHIVE_DIR=/app/archive \
DATABASE_URL=postgres://ssw:[email protected]:5432/ssw-ontology?sslmode=disable \
SEED_ON_START=true \
ALLOW_CORS=true \
AI_ENABLED=false
EXPOSE 8081
# 健康检查: 打 /api/v1/version —— 自 v1.3.1 密钥收紧后 connector 接口无头请求返回 401,
# 用免鉴权的 version 端点探活 (返回注入的 version/commit/build_time, 同样能证明二进制存活)。
HEALTHCHECK --interval=30s --timeout=10s --retries=3 --start-period=60s \
CMD wget -q --spider http://127.0.0.1:8081/api/v1/version || exit 1
ENTRYPOINT ["/usr/local/bin/entrypoint.sh"]