如何用Azure Bicep为第二个存储账户添加Blob容器

场景与问题描述 #

我有一个StorageAccount.bicep模块，代码如下：

//StorageAccount.bicep
param storageAccountSku string = 'Standard_LRS'
param storageAccountName string
param storageAccountType string = 'StorageV2'

resource storageAccount 'Microsoft.Storage/storageAccounts@2021-08-01' = {
  name: storageAccountName
  location: location
  tags: tags
  sku: {
    name: storageAccountSku
  }
  kind: storageAccountType
}

output name string = storageAccount.name

在main.bicep中调用该模块创建两个存储账户：
第一个存储账户的部署代码：

module storage_account_1 'modules/storageAccount.bicep' = {
  name: 'storage_account1'
  scope: rg
  params: {
    storageAccountSku: 'Standard_LRS'
    storageAccountType: 'StorageV2'
    storageAccountName: 'storage_account1'
  }
}

第二个存储账户使用变量生成名称，部署代码：

var storageName = toLower('${envType}${rgNameUid}${toLower(app)}')
module storage_account_2 'modules/storageAccount.bicep' = {
  name: 'storage_account2'
  scope: rg
  params: {
    storageAccountSku: 'Standard_LRS'
    storageAccountType: 'StorageV2'
    storageAccountName: storageName 
  }
}

还有一个helper.bicep用于配置或覆写存储账户设置：

//helper.bicep
resource my_storage 'Microsoft.Storage/storageAccounts@2022-05-01' existing = {
  name: storageName 
}

我的问题：

1. 如何为第二个存储账户添加Blob容器？我尝试创建blobContainer.bicep模块并在main.bicep中调用，但在dependsOn处报错，能否将模块声明为参数传入？
2. 是否可以采用以下写法在helper.bicep中添加Blob容器？

//helper.bicep

resource my_storage 'Microsoft.Storage/storageAccounts@2022-05-01' existing = {
  name: storageName 
}

//Add the following lines
resource storagecontainer 'Microsoft.Storage/storageAccounts/blobServices/containers@2022-05-01' = {
   name: '${storageName}/default/mycontainer'
   dependsOn: [
       my_storage 
     ]
   }

解答 #

一、解决blobContainer.bicep模块调用的dependsOn报错问题 #

不能将模块声明直接作为参数传入，但可以通过模块的输出值建立依赖关系，具体步骤如下：

1. 创建blobContainer.bicep模块，接收存储账户名称作为参数：

// blobContainer.bicep
param storageAccountName string
param containerName string = 'mycontainer'

resource storageContainer 'Microsoft.Storage/storageAccounts/blobServices/containers@2022-05-01' = {
  name: '${storageAccountName}/default/${containerName}'
  properties: {
    publicAccess: 'None' // 根据需求设置容器访问权限
  }
}

2. 在main.bicep中调用该模块时，通过第二个存储账户模块的输出值自动建立依赖（Bicep会自动推断模块间依赖，无需手动写dependsOn）：

var storageName = toLower('${envType}${rgNameUid}${toLower(app)}')
module storage_account_2 'modules/storageAccount.bicep' = {
  name: 'storage_account2'
  scope: rg
  params: {
    storageAccountSku: 'Standard_LRS'
    storageAccountType: 'StorageV2'
    storageAccountName: storageName 
  }
}

// 调用blobContainer模块，依赖由参数引用自动建立
module storage_container_2 'modules/blobContainer.bicep' = {
  name: 'storage_container2'
  scope: rg
  params: {
    storageAccountName: storage_account_2.outputs.name
    containerName: 'mycontainer' // 可自定义容器名称
  }
}

若需手动指定依赖，可添加：

dependsOn: [storage_account_2]

但通常无需手动设置，Bicep会自动处理。

二、关于helper.bicep中添加Blob容器的写法可行性 #

这种写法是可行的，但需要修正几个细节：

1. 补充参数传递：helper.bicep需要接收storageName作为参数，否则会找不到该变量；
2. API版本一致性：建议保持与存储账户模块的API版本一致，避免潜在兼容性问题；
3. 必填属性补充：容器资源必须指定publicAccess属性，否则部署会报错；
4. 优化资源引用：直接引用existing资源的name属性，比拼接字符串更可靠。

修正后的helper.bicep代码：

// helper.bicep
param storageName string

resource my_storage 'Microsoft.Storage/storageAccounts@2021-08-01' existing = {
  name: storageName 
}

resource storagecontainer 'Microsoft.Storage/storageAccounts/blobServices/containers@2021-08-01' = {
  name: '${my_storage.name}/default/mycontainer'
  properties: {
    publicAccess: 'None'
  }
  // 此处dependsOn可省略，通过${my_storage.name}已自动建立依赖
}

在main.bicep中调用该helper模块：

module storage_helper_2 'modules/helper.bicep' = {
  name: 'storage_helper2'
  scope: rg
  params: {
    storageName: storage_account_2.outputs.name
  }
}

两种方案对比 #

• 模块化拆分方案（blobContainer.bicep）：符合模块化设计原则，复用性强，适合需要批量创建容器或多处复用容器创建逻辑的场景；
• helper方案：更适合对已存在的存储账户进行后续配置的场景，比如后期补充容器或修改存储账户属性。

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