如何基于mongodb/mongodb-atlas-local构建带自定义Mongo参数的Docker镜像

问题根源 #

直接用mongod命令启动会缺失Atlas Search必需的特殊配置，官方的runner server虽然能正常启用搜索功能，但默认不支持自定义副本集名称、端口这类参数——核心解决思路是让runner带着我们的自定义参数启动，同时保留它自带的搜索功能配置。

方案一：自定义入口脚本传参 #

最简便的方式是套一层启动脚本，把自定义参数传递给runner server：

1. 编写Dockerfile #

FROM mongodb/mongodb-atlas-local:latest

# 复制自定义启动脚本到镜像内
COPY entrypoint.sh /usr/local/bin/entrypoint.sh
RUN chmod +x /usr/local/bin/entrypoint.sh

# 设置默认环境变量，启动时可通过-e参数覆盖
ENV REPLICA_SET_NAME=rs0
ENV SERVICE_PORT=27017

ENTRYPOINT ["/usr/local/bin/entrypoint.sh"]

2. 编写entrypoint.sh脚本 #

#!/bin/bash
set -e

# 将自定义参数注入runner server启动命令，自动保留Atlas Search配置
exec /usr/local/bin/runner server \
  --replSet "$REPLICA_SET_NAME" \
  --port "$SERVICE_PORT" \
  --bind_ip_all

启动容器时，还能通过docker run -e REPLICA_SET_NAME=my-rs这种方式动态修改参数，完全不影响Atlas Search功能。

方案二：自定义配置文件 #

如果需要更复杂的配置（比如认证、日志规则），可以直接编写mongod配置文件，让runner加载这个配置启动：

1. 编写自定义mongod.conf #

net:
  port: ${SERVICE_PORT:-27017}
  bindIpAll: true
replication:
  replSetName: ${REPLICA_SET_NAME:-rs0}
# 必须保留这一行，否则Atlas Search无法启用
atlasSearch:
  enabled: true
# 其他默认配置（如存储、日志）可从原镜像中复制补充

2. 编写Dockerfile #

FROM mongodb/mongodb-atlas-local:latest

# 替换镜像默认的配置文件
COPY mongod.conf /etc/mongod.conf

ENV REPLICA_SET_NAME=rs0
ENV SERVICE_PORT=27017

# 指定runner使用自定义配置文件启动
ENTRYPOINT ["/usr/local/bin/runner", "server", "--config", "/etc/mongod.conf"]

验证配置有效性 #

启动容器后，连接MongoDB执行以下命令验证：

# 检查副本集名称是否符合自定义设置
rs.status()

# 测试Atlas Search功能是否正常
db.test_collection.createSearchIndex({
  definition: {
    mappings: {
      dynamic: true
    }
  }
})

若能成功创建搜索索引，说明配置生效且Atlas Search功能正常。

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