Freigeben über

Schnellstart: Erstellen eines Azure App Configuration-Speichers mithilfe von Bicep

  • Artikel

In dieser Schnellstartanleitung wird beschrieben, wie Sie Bicep für Folgendes verwenden können:

  • Bereitstellen eines App Configuration-Speichers
  • Erstellen von Schlüsselwerten in einem App Configuration-Speicher
  • Lesen von Schlüsselwerten in einem App Configuration-Speicher

Bicep ist eine domänenspezifische Sprache (Domain-Specific Language, DSL), die eine deklarative Syntax zur Bereitstellung von Azure-Ressourcen verwendet. Sie bietet eine präzise Syntax, zuverlässige Typsicherheit und Unterstützung für die Wiederverwendung von Code. Bicep bietet die beste Form der Erstellung für Ihre Infrastructure-as-Code-Lösungen in Azure.

Voraussetzungen

Wenn Sie kein Azure-Abonnement besitzen, können Sie ein kostenloses Konto erstellen, bevor Sie beginnen.

Autorisierung

Für die Verwaltung einer Azure App-Konfigurationsressource mit Bicep-Datei ist eine Azure Resource Manager-Rolle erforderlich, z. B. Mitwirkender oder Besitzer. Für den Zugriff auf Azure App-Konfigurationsdaten (Schlüsselwerte, Momentaufnahmen) ist eine Azure Resource Manager-Rolle und eine zusätzliche Azure App-Konfigurationsdatenebenenrolle erforderlich, wenn der ARM-Authentifizierungsmodus des Konfigurationsspeichers auf den Pass-Through-ARM-Authentifizierungsmodus festgelegt ist.

Wichtig

Die Konfiguration des ARM-Authentifizierungsmodus erfordert App Configuration Steuerungsebenen-API Version 2023-08-01-preview oder höher.

Überprüfen der Bicep-Datei

Die in dieser Schnellstartanleitung verwendete Bicep-Datei stammt aus den Azure-Schnellstartvorlagen.

Hinweis

Bicep-Dateien verwenden dasselbe zugrunde liegende Modul wie ARM-Vorlagen. Alle Tipps, Notizen und wichtigen Informationen, die im Schnellstart ARM-Vorlage zu finden sind, gelten hier. Es wird empfohlen, auf diese Informationen zu verweisen, wenn Sie mit Bicep-Dateien arbeiten.

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

In der Bicep-Datei sind zwei Azure-Ressourcen definiert:

Mit dieser Bicep-Datei erstellen Sie einen Schlüssel mit zwei unterschiedlichen Werten, von denen einer eine eindeutige Bezeichnung hat.

Bereitstellen der Bicep-Datei

  1. Speichern Sie die Bicep-Datei als main.bicep auf Ihrem lokalen Computer.

  2. Stellen Sie die Bicep-Datei entweder mit Azure CLI oder mit Azure PowerShell bereit.

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

    Hinweis

    Ersetzen Sie <store-name> durch den Namen Ihres App Configuration-Speichers.

    Nach Abschluss der Bereitstellung sollte eine Meldung mit dem Hinweis angezeigt werden, dass die Bereitstellung erfolgreich war.

Überprüfen der bereitgestellten Ressourcen

Verwenden Sie die Azure CLI oder Azure PowerShell, um die bereitgestellten Ressourcen in der Ressourcengruppe aufzulisten.

az resource list --resource-group exampleRG

Sie können auch das Azure-Portal verwenden, um die Ressourcen aufzulisten:

  1. Melden Sie sich beim Azure-Portal an.
  2. Geben Sie im Suchfeld App Configuration ein, und wählen Sie dann App Configuration aus der Liste aus.
  3. Wählen Sie die neu erstellte App Configuration-Ressource aus.
  4. Wählen Sie unter Vorgänge die Option Konfigurations-Explorer aus.
  5. Vergewissern Sie sich, dass zwei Schlüsselwerte vorhanden sind.

Bereinigen von Ressourcen

Wenn die Ressourcengruppe und deren Ressourcen nicht mehr benötigt werden, löschen Sie sie über die Azure CLI oder Azure PowerShell.

az group delete --name exampleRG

Sie können die Ressourcengruppe auch über das Azure-Portal löschen:

  1. Wechseln Sie zu Ihrer Ressourcengruppe.
  2. Wählen Sie die Option Ressourcengruppe löschen.
  3. Eine Registerkarte wird angezeigt. Geben Sie den Ressourcengruppennamen ein, und wählen Sie Löschen aus.

Nächste Schritte

Sehen Sie sich die Beispiele für ARM-Vorlagen an, um sich über das Hinzufügen von Featureflags zu informieren und sich mit dem App Configuration-Speicher vertraut zu machen.