删除Docker容器后CosmosDB Emulator数据丢失问题求助

核心问题分析 #

CosmosDB Emulator启用数据持久化时，实际的持久化数据并非仅存储在/data/db目录，默认会分散在多个路径中。仅挂载/data/db无法覆盖所有需要持久化的内容，这就导致删除容器后，卷虽保留但关键数据并未写入其中，新容器无法复用数据。

具体解决方法 #

1. 调整docker-compose.yml的卷挂载配置 #

需要将Emulator所有涉及持久化的目录都映射到目标Docker卷，包括数据目录、临时目录和元数据目录。修改后的配置示例：

version: '3.8'
services:
  cosmosdb-emulator:
    image: mcr.microsoft.com/cosmosdb/linux/azure-cosmos-emulator:latest
    container_name: cosmosdb-emulator
    environment:
      - AZURE_COSMOS_EMULATOR_ENABLE_DATA_PERSISTENCE=true
      - AZURE_COSMOS_EMULATOR_PARTITION_COUNT=1
      - AZURE_COSMOS_EMULATOR_ENABLE_AUTHENTICATION=true
    ports:
      - "8081:8081"
      - "10251:10251"
      - "10252:10252"
      - "10253:10253"
      - "10254:10254"
    volumes:
      - vol_cosmos:/data/db
      - vol_cosmos:/tmp/cosmos
      - vol_cosmos:/usr/local/cosmos-emulator
volumes:
  vol_cosmos:
    external: false # 保持内部卷属性，避免删除容器时卷被连带删除

2. 修复卷的权限问题 #

CosmosDB Emulator容器内进程以特定权限运行，若卷的所有权不匹配会导致无法写入数据。可通过临时容器修正权限：

# 启动临时Alpine容器挂载目标卷，修改目录所有权
docker run --rm -v vol_cosmos:/data alpine chown -R 10001:0 /data

执行完成后再启动CosmosDB Emulator容器，确保进程能正常读写卷内数据。

3. 验证数据复用效果 #

删除现有容器后，重新启动容器：

docker-compose down
docker-compose up -d

启动后打开CosmosDB Emulator Explorer，检查之前创建的数据是否存在，若正常加载则说明持久化配置生效。

关键注意事项 #

• 禁止使用docker-compose down -v命令，该命令会删除关联卷，直接导致数据丢失；仅用docker-compose down只会删除容器和网络，保留卷。
• 若旧卷已存在但未正确挂载所有目录，建议先备份卷内数据（如有），再删除旧卷重新创建：

docker volume rm vol_cosmos
docker-compose up -d

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