Docker中EdgeDB执行迁移后自动停止问题求助

问题现象 #

迁移执行完成后，EdgeDB服务无预警自行停止，日志显示进程先收到SIGTERM（信号15）触发关闭流程，最终被强制终止。

相关配置 #

1. Docker Compose配置 #

version: '3.9'

volumes:
  edgedb_meta:
  edgedb_data:

services:
  wissance_ubs_db:
    container_name: wissance_ubs_db
    volumes:
      - edgedb_meta:/dbschema
      - edgedb_data:/var/lib/edgedb/data
    build:
      context: .
      dockerfile: ./Edgedb.Dockerfile
    # stdin_open: true
    # tty: true
    env_file: ./deploy_settings.env
    ports:
      - "5656:5656"
    expose:
      - "5656"

  wissance_ubs_webapi_backend:
    container_name: wissance_ubs_webapi_backend
    depends_on:
      wissance_ubs_db:
        condition: service_started    
    volumes:
      - edgedb_meta:/root/.config/edgedb/credentials
    build:
      context: .
      dockerfile: ./Wissance.Ubs.Dockerfile
    stdin_open: true
    tty: true
    env_file: ./deploy_settings.env
    ports:
      - "8228:8228"

2. EdgeDB Dockerfile #

FROM edgedb/edgedb:4.7 AS base
VOLUME /dbschema

#WORKDIR /dbschema/
WORKDIR /opt

# 根据文档，迁移文件应放在/dbschema/migrations下
COPY ./src/Wissance.Ubs/Wissance.Ubs.Data/dbschema /dbschema
# 复制toml配置
COPY ./src/Wissance.Ubs/Wissance.Ubs.Data/edgedb.toml /dbschema
COPY ./docs/data_init/init.eql /dbschema
# 复制Python配置生成脚本
COPY ./utils/edgedb_cfg_writer.py /dbschema

# 安装Python3
RUN apt-get update && apt-get install python3 -y

# 配置EdgeDB并复制凭证到卷
ARG EDGEDB_SERVER_PASSWORD=_mySuperPass_
ARG EDGEDB_SERVER_INSTANCE_NAME=Wissance_Ubs
RUN /usr/bin/python3 /dbschema/edgedb_cfg_writer.py
RUN cp /root/.config/edgedb/credentials/${EDGEDB_SERVER_INSTANCE_NAME}.json /dbschema

CMD ["edgedb-server"]

3. 环境变量片段 #

EDGEDB_DOCKER_APPLY_MIGRATIONS=always
EDGEDB_DOCKER_LOG_LEVEL=debug
EDGEDB_DOCKER_BOOTSTRAP_TIMEOUT_SEC=3600

EDGEDB_SERVER_PASSWORD=_mySuperPass_
EDGEDB_SERVER_TLS_CERT_MODE=generate_self_signed
EDGEDB_SERVER_ADMIN_UI=enabled
EDGEDB_SERVER_SECURITY=insecure_dev_mode
EDGEDB_SERVER_HTTP_ENDPOINT_SECURITY=optional
EDGEDB_SERVER_BINARY_ENDPOINT_SECURITY=optional
EDGEDB_SERVER_INSTANCE_NAME=Wissance_Ubs
EDGEDB_SERVER_EMIT_SERVER_STATUS=true
EDGEDB_SERVER_COMPILER_POOL_SIZE=64

日志信息 #

wissance_ubs_db              | Applied m1e4lbd2auubps6tx5sy5emdys4y2hrll3owcrxxxa66wsidu223fq (00001.edgeql)
wissance_ubs_db              | INFO 45 2024-05-13T06:41:30.617 edb.server: Connection established to backend database: edgedb
wissance_ubs_webapi_backend  | dbug: Quartz.Core.QuartzSchedulerThread[0]
wissance_ubs_webapi_backend  |       Batch acquisition of 0 triggers
wissance_ubs_db              | INFO 45 2024-05-13T06:41:35.558 edb.server: introspecting database 'edgedb'
wissance_ubs_db              | INFO 45 2024-05-13T06:41:36.319 edb.server: Connection established to backend database: edgedb
wissance_ubs_db              | INFO 45 2024-05-13T06:41:37.021 edb.server: Received signal: 15.
wissance_ubs_db              | INFO 45 2024-05-13T06:41:39.167 edb.server: Shutting down.
wissance_ubs_db              | /usr/local/bin/docker-entrypoint-funcs.sh: line 1327:    45 Killed                  gosu "${EDGEDB_SERVER_UID}" env -i "${pg_vars[@]}" "${EDGEDB_SERVER_BINARY}" "${server_opts[@]}"

原因分析与解决方法 #

核心原因 #

日志中Received signal: 15是关键线索：信号15为SIGTERM，结合最终Killed提示，大概率是以下两类问题：

1. 资源耗尽：容器内存/CPU配额不足，触发宿主机OOM Killer强制终止进程
2. 启动流程冲突：自定义Dockerfile逻辑绕过了官方entrypoint的服务守护流程，导致迁移完成后进程未持续运行

针对性解决步骤 #

1. 排查并解决资源限制问题

• 给EdgeDB容器添加资源配额，在docker-compose.yml的wissance_ubs_db服务中加入：

  deploy:
    resources:
      limits:
        memory: 2G
      reservations:
        memory: 1G
  

• 检查宿主机OOM日志（Linux执行dmesg | grep oom-killer），确认是否因内存不足导致进程被杀死。

2. 修复Dockerfile启动逻辑

官方EdgeDB镜像的entrypoint会自动处理迁移、实例配置和服务守护，自定义逻辑可能破坏该流程：

• 删除Dockerfile中的RUN /usr/bin/python3 /dbschema/edgedb_cfg_writer.py和RUN cp ...步骤，改用环境变量完成实例配置
• 移除CMD ["edgedb-server"]，让官方entrypoint接管启动——该entrypoint会在迁移完成后保持服务持续运行，避免进程自行退出。

3. 优化服务依赖检查

将webapi服务的depends_on条件改为service_healthy，添加DB健康检查确保服务就绪后再启动：
在wissance_ubs_db服务中加入：

healthcheck:
  test: ["CMD", "edgedb", "query", "SELECT 1"]
  interval: 5s
  timeout: 5s
  retries: 5

同时修改webapi的depends_on：

depends_on:
  wissance_ubs_db:
    condition: service_healthy

内容的提问来源于stack exchange，提问作者Michael Ushakov