Partilhar via

Guia de início rápido: criar uma loja de configuração de aplicativos do Azure usando o Bicep

  • Artigo

Este guia de início rápido descreve como você pode usar o Bicep para:

  • Implante uma loja de configuração de aplicativos.
  • Crie valores-chave em uma loja de configuração de aplicativos.
  • Leia os valores-chave em uma loja de configuração de aplicativos.

O Bicep é uma linguagem específica do domínio que utiliza sintaxe declarativa para implementar recursos do Azure. Fornece sintaxe concisa, segurança de tipos fiável e suporte para reutilização de código. O Bicep oferece a melhor experiência de criação para suas soluções de infraestrutura como código no Azure.

Pré-requisitos

Se não tiver uma subscrição do Azure, crie uma conta gratuita antes de começar.

Autorização

Gerenciar um recurso de Configuração de Aplicativo do Azure com o arquivo Bicep requer uma função do Gerenciador de Recursos do Azure, como colaborador ou proprietário. O acesso aos dados de Configuração do Aplicativo do Azure (valores-chave, instantâneos) requer uma função do Gerenciador de Recursos do Azure e uma função adicional do plano de dados da Configuração do Aplicativo do Azure quando o modo de autenticação ARM do repositório de configuração estiver definido para o modo de autenticação ARM de passagem.

Importante

A configuração do modo de autenticação ARM requer a versão 2023-08-01-preview da API do plano de controle de configuração do aplicativo ou posterior.

Revise o arquivo Bicep

O arquivo Bicep usado neste início rápido é de Modelos de Início Rápido do Azure.

Nota

Os arquivos Bicep usam o mesmo mecanismo subjacente que os modelos ARM. Todas as dicas, notas e informações importantes encontradas no guia de início rápido do modelo ARM se aplicam aqui. Recomenda-se fazer referência a essas informações ao trabalhar com arquivos Bicep.

@description('Specifies the name of the App Configuration store.')
param configStoreName string = 'appconfig${uniqueString(resourceGroup().id)}'

@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@2024-05-01' = {
  name: configStoreName
  location: location
  sku: {
    name: 'standard'
  }
}

resource configStoreKeyValue 'Microsoft.AppConfiguration/configurationStores/keyValues@2024-05-01' = [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 = {
  name: configStoreKeyValue[1].name
  properties: configStoreKeyValue[1].properties
}

Dois recursos do Azure são definidos no arquivo Bicep:

Com este arquivo Bicep, criamos uma chave com dois valores diferentes, um dos quais tem um rótulo exclusivo.

Implantar o arquivo Bicep

  1. Salve o arquivo Bicep como main.bicep em seu computador local.

  2. Implante o arquivo Bicep usando a CLI do Azure ou 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

    Substitua <o nome> da loja pelo nome da loja de Configuração de Aplicativos.

    Quando a implantação terminar, você verá uma mensagem indicando que a implantação foi bem-sucedida.

Rever os recursos implementados

Use a CLI do Azure ou o Azure PowerShell para listar os recursos implantados no grupo de recursos.

az resource list --resource-group exampleRG

Você também pode usar o portal do Azure para listar os recursos:

  1. Inicie sessão no portal do Azure.
  2. Na caixa de pesquisa, introduza Configuração da Aplicação e, em seguida, selecione Configuração da Aplicação na lista.
  3. Selecione o recurso de Configuração do Aplicativo recém-criado.
  4. Em Operações, selecione Gerenciador de configurações.
  5. Verifique se existem dois valores-chave.

Clean up resources (Limpar recursos)

Quando não for mais necessário, use a CLI do Azure ou o Azure PowerShell para excluir o grupo de recursos e seus recursos.

az group delete --name exampleRG

Você também pode usar o portal do Azure para excluir o grupo de recursos:

  1. Navegue para o grupo de recursos.
  2. Selecione Eliminar grupo de recursos.
  3. Será apresentado um separador. Insira o nome do grupo de recursos e selecione Excluir.

Próximos passos

Para saber mais sobre como adicionar sinalizador de recurso e referência do Cofre da Chave a uma loja de Configuração de Aplicativos, confira os exemplos de modelo ARM.