Sdílet prostřednictvím

Rychlý start: Vytvoření úložiště konfigurace Aplikace Azure pomocí Bicep

  • Článek

Tento rychlý start popisuje, jak můžete pomocí nástroje Bicep provádět následující akce:

  • Nasaďte App Configuration Store.
  • Vytvořte hodnoty klíčů v obchodě App Configuration.
  • Čtení hodnot klíč-hodnoty v App Configuration Storu

Bicep je jazyk specifický pro doménu (DSL), který k nasazování prostředků Azure používá deklarativní syntaxi. Poskytuje stručnou syntaxi, spolehlivou bezpečnost typů a podporu pro opakované použití kódu. Bicep nabízí nejlepší prostředí pro vytváření obsahu pro řešení infrastruktury jako kódu v Azure.

Požadavky

Pokud ještě nemáte předplatné Azure, vytvořte si napřed bezplatný účet.

Autorizace

Správa prostředku konfigurace Aplikace Azure pomocí souboru Bicep vyžaduje roli Azure Resource Manageru, například přispěvatele nebo vlastníka. Přístup ke konfiguračním datům Aplikace Azure (hodnoty klíče, snímky) vyžaduje roli Azure Resource Manageru a další roli roviny dat konfigurace Aplikace Azure, pokud je režim ověřování ARM úložiště konfigurace nastavený na předávací režim ověřování ARM.

Důležité

Konfigurace režimu ověřování ARM vyžaduje verzi 2023-08-01-preview rozhraní API řídicí roviny konfigurace aplikace nebo novější.

Kontrola souboru Bicep

Soubor Bicep použitý v tomto rychlém startu pochází ze šablon Azure Pro rychlý start.

Poznámka:

Soubory Bicep používají stejný základní modul jako šablony ARM. Tady platí všechny tipy, poznámky a důležité informace, které najdete v šabloně ARM. Při práci se soubory Bicep doporučujeme na tyto informace odkazovat.

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

V souboru Bicep se definují dva prostředky Azure:

V tomto souboru Bicep vytvoříme jeden klíč se dvěma různými hodnotami, z nichž jeden má jedinečný popisek.

Nasazení souboru Bicep

  1. Uložte soubor Bicep jako main.bicep do místního počítače.

  2. Nasaďte soubor Bicep pomocí Azure CLI nebo Azure PowerShellu.

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

    Poznámka:

    Nahraďte <název obchodu názvem> obchodu App Configuration Store.

    Po dokončení nasazení by se měla zobrazit zpráva, že nasazení bylo úspěšné.

Kontrola nasazených prostředků

K výpisu nasazených prostředků ve skupině prostředků použijte Azure CLI nebo Azure PowerShell.

az resource list --resource-group exampleRG

K výpisu prostředků můžete použít také Azure Portal:

  1. Přihlaste se k portálu Azure.
  2. Do vyhledávacího pole zadejte App Configuration a ze seznamu vyberte App Configuration (Konfigurace aplikace).
  3. Vyberte nově vytvořený prostředek App Configuration.
  4. V části Operace vyberte Průzkumníka konfigurace.
  5. Ověřte, že existují dvě hodnoty klíče.

Vyčištění prostředků

Pokud už ji nepotřebujete, odstraňte skupinu prostředků a její prostředky pomocí Azure CLI nebo Azure PowerShellu.

az group delete --name exampleRG

Skupinu prostředků můžete odstranit také pomocí webu Azure Portal:

  1. Přejděte k vaší skupině prostředků.
  2. Vyberte Odstranit skupinu prostředků.
  3. Zobrazí se karta. Zadejte název skupiny prostředků a vyberte Odstranit.

Další kroky

Další informace o přidání příznaku funkce a odkazu služby Key Vault do úložiště konfigurace aplikací najdete v příkladech šablon ARM.