M2 macOS运行Azure Cosmos DB Emulator容器启动后立即停止且无日志

问题复现 #

在M2芯片的macOS上执行以下Docker命令：

docker run --platform linux/amd64 \
--publish 8081:8081 \
--publish 10250-10255:10250-10255 \
--interactive \
--tty \
mcr.microsoft.com/cosmosdb/linux/azure-cosmos-emulator:latest

容器仅输出以下日志后立即停止：

This is an evaluation version. There are [24] days left in the evaluation period.
2024-04-04 13:18:22 Starting

可能原因 #

• 架构转译兼容性问题：M2为arm64架构，使用--platform linux/amd64依赖Docker Rosetta转译运行amd64镜像，而Azure Cosmos DB Emulator对底层环境要求较高，转译过程中可能出现未捕获的兼容性错误导致容器退出。
• 资源不足：Cosmos DB Emulator官方要求至少4GB内存，默认Docker资源分配可能低于此阈值，容器启动时因内存不足直接终止。
• 端口冲突：本地已有服务占用8081或10250-10255范围内的端口，导致容器无法绑定端口启动失败。

可行解决方案 #

方案1：使用arm64预览版镜像（推荐） #

微软已推出arm64架构的Cosmos DB Emulator预览镜像，无需转译，直接适配M2芯片：

1. 拉取arm64预览镜像：

docker pull mcr.microsoft.com/cosmosdb/linux/azure-cosmos-emulator:preview-arm64

2. 启动容器（指定至少4GB内存）：

docker run --publish 8081:8081 \
--publish 10250-10255:10250-10255 \
--memory 4g \
--interactive \
--tty \
mcr.microsoft.com/cosmosdb/linux/azure-cosmos-emulator:preview-arm64

方案2：优化amd64镜像的运行配置 #

如果必须使用官方amd64镜像，调整Docker资源配置并补充参数：

1. 打开Docker Desktop，进入「Settings > Resources」，将内存分配调整为4GB以上，CPU核心数设置为4核及以上。
2. 检查端口占用情况，执行以下命令查看8081端口是否被占用：

lsof -i :8081

若有占用，使用kill -9 <进程PID>终止对应进程。
3. 重新运行容器时添加内存限制参数：

docker run --platform linux/amd64 \
--publish 8081:8081 \
--publish 10250-10255:10250-10255 \
--memory 4g \
--interactive \
--tty \
mcr.microsoft.com/cosmosdb/linux/azure-cosmos-emulator:latest

方案3：使用Azure Cosmos DB免费层级替代 #

若本地模拟器不是必需选项，可直接在Azure Portal创建免费层级的Cosmos DB账户，通过远程连接进行开发测试，完全规避本地容器的兼容性问题。

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