Azure Cosmos DB Emulator Linux镜像启动失败（错误：评估期已过期）

问题详情 #

使用mcr.microsoft.com/cosmosdb/linux/azure-cosmos-emulator:latest镜像，在Windows/Mac的Docker Desktop或CLI启动容器时，均触发相同错误：

2022-11-15 16:34:08 Error: The evaluation period has expired.
2022-11-15 16:34:08 ./cosmosdb-emulator: ERROR: PAL initialization failed. Error: 104

已尝试删除容器、重新拉取最新镜像，问题仍未解决。

解决办法 #

这个错误的核心原因是latest标签对应的镜像内置许可已过期，即使重新拉取也无法修复。解决步骤如下：

1. 替换为具体未过期的版本号
   放弃使用latest标签，选择Azure Cosmos DB Linux模拟器的最新稳定版本号（比如2.14.0或更新版本），修改启动命令：

   docker run --name azure-cosmosdb-emulator --memory 2GB --interactive --tty -p 8081:8081 -p 8900:8900 -p 8901:8901 -p 8902:8902 -p 10250:10250 -p 10251:10251 -p 10252:10252 -p 10253:10253 -p 10254:10254 -p 10255:10255 -p 10256:10256 -p 10350:10350 mcr.microsoft.com/cosmosdb/linux/azure-cosmos-emulator:2.14.0
   

2. 清理旧资源（可选但推荐）
   先清理之前的容器和旧镜像，避免资源冲突：

   docker stop azure-cosmosdb-emulator
   docker rm azure-cosmosdb-emulator
   docker rmi mcr.microsoft.com/cosmosdb/linux/azure-cosmos-emulator:latest
   

3. 拉取指定版本并启动
   执行修改后的启动命令，拉取对应版本镜像并启动容器即可正常运行。

如果不确定可用的稳定版本，可以查看Azure容器注册表中该镜像的标签列表，选择最近发布的版本即可。

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