如何在Azure Cosmos DB中预创建集合 需纳入Azure DevOps流水线吗

你可以通过以下几种常用方式实现Cosmos DB部署后自动创建所需集合，无需手动操作：

• IaC模板内置定义：在编写ARM、Bicep、Terraform等基础设施即代码模板时，除了Cosmos DB账户、数据库资源之外，直接把集合的配置（分区键、吞吐量、索引策略、TTL规则等）也作为资源定义写入模板，部署时会随Cosmos DB账户一并创建完成，是最推荐的生产级方案。
  示例Bicep资源定义片段：

  resource cosmosSqlContainer 'Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers@2023-11-15' = {
    name: '${cosmosAccount.name}/${sqlDb.name}/${containerName}'
    properties: {
      resource: {
        id: containerName
        partitionKey: {
          paths: [
            '/userId'
          ]
          kind: 'Hash'
        }
        indexingPolicy: {
          indexingMode: 'consistent'
          automatic: true
        }
      }
      options: {
        throughput: 400
      }
    }
  }
  

• 部署后置脚本执行：如果集合配置有动态逻辑，或者需要和业务逻辑结合创建，可以在Cosmos DB资源部署完成后，通过Azure CLI、PowerShell或者对应语言的Cosmos DB SDK执行创建集合的脚本。
  示例Azure CLI创建集合命令：

  az cosmosdb sql container create \
    --account-name <你的Cosmos账户名> \
    --database-name <数据库名> \
    --name <集合名> \
    --partition-key-path "/userId" \
    --throughput 400
  

非常建议将Cosmos DB的全量部署、集合配置变更都纳入DevOps的API部署流水线中，原因如下：

• 可以实现多环境配置统一，避免开发、测试、生产环境因为手动配置出现集合分区键、索引规则不一致的问题，减少环境差异导致的线上bug
• 可以和API版本做绑定发布，如果API迭代需要调整集合的索引、新增字段的索引规则，或者新增集合，都可以随API版本一起发布，保证API启动时所需的依赖资源已经就绪
• 生产环境可以在流水线中加入变更校验、dry run步骤，避免手动操作导致的集合误删、配置错误等故障

如果是已上线的有状态Cosmos DB实例，建议在流水线的集合创建逻辑中加入存在性判断，仅在集合不存在时新建，已存在时只更新吞吐量、索引等可变更配置，避免影响已有数据。

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