Dela via

Snabbstart: Skapa ett Azure App Configuration Store med Bicep

  • Artikel

Den här snabbstarten beskriver hur du kan använda Bicep för att:

  • Distribuera ett appkonfigurationsarkiv.
  • Skapa nyckelvärden i ett appkonfigurationsarkiv.
  • Läs nyckelvärden i ett appkonfigurationsarkiv.

Bicep är ett domänspecifikt språk (DSL) som använder deklarativ syntax för att distribuera Azure-resurser. Det ger koncis syntax, tillförlitlig typsäkerhet och stöd för återanvändning av kod. Bicep erbjuder den bästa redigeringsupplevelsen för dina infrastruktur-som-kod-lösningar i Azure.

Förutsättningar

Om du inte har någon Azure-prenumeration skapar du ett kostnadsfritt konto innan du börjar.

Auktorisering

För att hantera en Azure App Configuration-resurs med Bicep-filen krävs en Azure Resource Manager-roll, till exempel deltagare eller ägare. Åtkomst till Azure App Configuration-data (nyckelvärden, ögonblicksbilder) kräver en Azure Resource Manager-roll och ytterligare en Azure App Configuration-dataplansroll när konfigurationsarkivets ARM-autentiseringsläge är inställt på genomströmningsläge för ARM-autentisering.

Viktigt!

För att konfigurera ARM-autentiseringsläget krävs api-version 2023-08-01-preview för appkonfigurationskontrollplan eller senare.

Granska Bicep-filen

Bicep-filen som används i den här snabbstarten kommer från Azure-snabbstartsmallar.

Kommentar

Bicep-filer använder samma underliggande motor som ARM-mallar. Alla tips, anteckningar och viktig information som finns i snabbstarten för ARM-mallen gäller här. Vi rekommenderar att du refererar till den här informationen när du arbetar med Bicep-filer.

@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
}

Två Azure-resurser definieras i Bicep-filen:

Med den här Bicep-filen skapar vi en nyckel med två olika värden, varav en har en unik etikett.

Distribuera Bicep-filen

  1. Spara Bicep-filen som main.bicep på den lokala datorn.

  2. Distribuera Bicep-filen med antingen Azure CLI eller Azure PowerShell.

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

    Kommentar

    Ersätt <store-name> med namnet på App Configuration Store.

    När distributionen är klar bör du se ett meddelande som anger att distributionen lyckades.

Granska distribuerade resurser

Använd Azure CLI eller Azure PowerShell för att lista de distribuerade resurserna i resursgruppen.

az resource list --resource-group exampleRG

Du kan också använda Azure Portal för att lista resurserna:

  1. Logga in på Azure-portalen.
  2. I sökrutan anger du AppKonfiguration och väljer sedan Appkonfiguration i listan.
  3. Välj den nyligen skapade appkonfigurationsresursen.
  4. Under Åtgärder väljer du Konfigurationsutforskaren.
  5. Kontrollera att det finns två nyckelvärden.

Rensa resurser

När den inte längre behövs använder du Azure CLI eller Azure PowerShell för att ta bort resursgruppen och dess resurser.

az group delete --name exampleRG

Du kan också använda Azure Portal för att ta bort resursgruppen:

  1. Gå till din resursgrupp.
  2. Välj Ta bort resursgrupp.
  3. En flik visas. Ange resursgruppens namn och välj Ta bort.

Nästa steg

Om du vill veta mer om hur du lägger till funktionsflagga och Key Vault-referens till ett appkonfigurationsarkiv kan du läsa ARM-mallexemplen.