Share via

Inicio rápido: crear un almacén de Azure App Configuration mediante Bicep

  • Artículo

En este inicio rápido se describe cómo puede usar Bicep para:

  • Implementar un almacén de App Configuration.
  • Crear los pares clave-valor de un almacén de App Configuration.
  • Leer los pares clave-valor de un almacén de App Configuration.

Bicep es un lenguaje específico de dominio (DSL) que usa una sintaxis declarativa para implementar recursos de Azure. Brinda sintaxis concisa, seguridad de tipos confiable y compatibilidad con la reutilización de código. Bicep ofrece la mejor experiencia de creación para sus soluciones de infraestructura como código en Azure.

Requisitos previos

Si no tiene una suscripción a Azure, cree una cuenta gratuita antes de empezar.

Authorization

La administración de un recurso de Azure App Configuration con el archivo Bicep requiere un rol de Azure Resource Manager, como colaborador o propietario. El acceso a los datos de Azure App Configuration (valores clave, instantáneas) requiere un rol de Azure Resource Manager y un rol adicional de plano de datos de Azure App Configuration cuando el modo de autenticación ARM del almacén de configuración se establece en modo de autenticación ARM detránsito.

Importante

La configuración del modo de autenticación de ARM requiere la versión 2023-08-01-preview de API del plano de control de App Configuration o posterior.

Revisión del archivo de Bicep

El archivo de Bicep usado en este inicio rápido forma parte de las plantillas de inicio rápido de Azure.

Nota

Los archivos de Bicep usan el mismo motor subyacente que las plantillas de ARM. Aquí se aplican todas las sugerencias, notas e información importante que se encuentra en el inicio rápido de la plantilla de ARM. Se recomienda hacer referencia a esta información al trabajar con archivos de Bicep.

@description('Specifies the name of the App Configuration store.')
param configStoreName string

@description('Specifies the Azure location where the app configuration store should be created.')
param location string = resourceGroup().location

@description('Specifies the names of the key-value resources. The name is a combination of key and label with $ as delimiter. The label is optional.')
param keyValueNames array = [
  'myKey'
  'myKey$myLabel'
]

@description('Specifies the values of the key-value resources. It\'s optional')
param keyValueValues array = [
  'Key-value without label'
  'Key-value with label'
]

@description('Specifies the content type of the key-value resources. For feature flag, the value should be application/vnd.microsoft.appconfig.ff+json;charset=utf-8. For Key Value reference, the value should be application/vnd.microsoft.appconfig.keyvaultref+json;charset=utf-8. Otherwise, it\'s optional.')
param contentType string = 'the-content-type'

@description('Adds tags for the key-value resources. It\'s optional')
param tags object = {
  tag1: 'tag-value-1'
  tag2: 'tag-value-2'
}

resource configStore 'Microsoft.AppConfiguration/configurationStores@2021-10-01-preview' = {
  name: configStoreName
  location: location
  sku: {
    name: 'standard'
  }
}

resource configStoreKeyValue 'Microsoft.AppConfiguration/configurationStores/keyValues@2021-10-01-preview' = [for (item, i) in keyValueNames: {
  parent: configStore
  name: item
  properties: {
    value: keyValueValues[i]
    contentType: contentType
    tags: tags
  }
}]

output reference_key_value_value string = configStoreKeyValue[0].properties.value
output reference_key_value_object object = configStoreKeyValue[1]

En el archivo Bicep, se definen dos recursos de Azure:

Con este archivo de Bicep, creamos una clave con dos valores diferentes, uno de los cuales tiene una etiqueta única.

Implementación del archivo de Bicep

  1. Guarde el archivo de Bicep como main.bicep en el equipo local.

  2. Implemente el archivo de Bicep mediante la CLI de Azure o Azure PowerShell.

    az group create --name exampleRG --location eastus
az deployment group create --resource-group exampleRG --template-file main.bicep --parameters configStoreName=<store-name>

    Nota

    Reemplace <nombre de almacén> por el nombre del almacén de App Configuration.

    Una vez finalizada la implementación, debería mostrarse un mensaje indicando que la implementación se realizó correctamente.

Revisión de los recursos implementados

Use la CLI de Azure o Azure PowerShell para enumerar los recursos implementados en el grupo de recursos.

az resource list --resource-group exampleRG

También puede usar Azure Portal para enumerar los recursos:

  1. Inicie sesión en Azure Portal.
  2. En el cuadro de búsqueda, escriba App Configuration y seleccione App Configuration en la lista.
  3. Seleccione el recurso de App Configuration recién creado.
  4. En Operaciones, seleccione Explorador de configuración.
  5. Compruebe que existen dos pares clave-valor.

Limpieza de recursos

Cuando ya no los necesite, use la CLI de Azure o Azure PowerShell para eliminar el grupo de recursos y sus recursos.

az group delete --name exampleRG

También puede usar Azure Portal para eliminar un grupo de recursos:

  1. Vaya al grupo de recursos.
  2. Seleccione Eliminar grupo de recursos.
  3. Aparecerá una pestaña. Escriba el nombre del grupo de recursos y seleccione Eliminar.

Pasos siguientes

Para obtener información sobre cómo agregar la marca de características y la referencia de Key Vault a un almacén de App Configuration, consulte los ejemplos de plantilla de ARM.