Szybki start: tworzenie magazynu Azure App Configuration przy użyciu Bicep

W tym przewodniku Szybki start opisano, jak za pomocą narzędzia Bicep wykonywać następujące czynności:

  • Wdróż magazyn App Configuration.
  • Utwórz wartości kluczy w magazynie usługi App Configuration.
  • Odczytywanie par klucz-wartość w magazynie App Configuration.

Bicep to język specyficzny dla domeny (DSL), który używa składni deklaratywnej do wdrażania zasobów platformy Azure. Zapewnia zwięzłą składnię, niezawodne bezpieczeństwo typów i obsługę ponownego użycia kodu. Bicep oferuje najlepsze środowisko tworzenia rozwiązań infrastruktury jako kodu na platformie Azure.

Wymagania wstępne

Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto.

Autoryzacja

Zarządzanie zasobem Azure App Configuration przy użyciu pliku Bicep wymaga roli Azure Resource Manager, takiej jak Współautor lub Właściciel. Dostęp do danych usługi Azure App Configuration (par klucz-wartość i migawek) wymaga roli usługi Azure Resource Manager oraz dodatkowej roli płaszczyzny danych usługi Azure App Configuration, gdy tryb uwierzytelniania ARM magazynu konfiguracji jest ustawiony na tryb uwierzytelniania ARM pass-through.

Ważne

Konfigurowanie trybu uwierzytelniania ARM wymaga wersji 2023-08-01-preview lub nowszej interfejsu API płaszczyzny sterowania App Configuration.

Przejrzyj plik Bicep

Plik Bicep używany w tym przewodniku Szybki start pochodzi z szablonów szybkiego startu platformy Azure.

Uwaga

Pliki Bicep korzystają z tego samego bazowego mechanizmu co szablony ARM. Wszystkie wskazówki, uwagi i ważne informacje zawarte w przewodniku Szybki start dotyczący szablonów ARM mają tu zastosowanie. Zaleca się odwołanie się do tych informacji podczas pracy z plikami 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
}

Dwa zasoby platformy Azure są zdefiniowane w pliku Bicep:

Za pomocą tego pliku Bicep utworzymy jeden klucz z dwoma różnymi wartościami, z których jedna ma unikatową etykietę.

Wdróż plik Bicep

  1. Zapisz plik Bicep jako main.bicep na komputerze lokalnym.

  2. Wdróż plik Bicep przy użyciu interfejsu wiersza polecenia platformy Azure lub programu Azure PowerShell.

    W poniższych przykładach zastąp <ResourceGroupName> nazwą swojej grupy zasobów, a <AppConfigurationStoreName> unikalną nazwą magazynu konfiguracji.

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

    Po zakończeniu wdrażania powinien zostać wyświetlony komunikat informujący o pomyślnym wdrożeniu.

Przeglądanie wdrożonych zasobów

Użyj interfejsu wiersza polecenia platformy Azure lub programu Azure PowerShell, aby wyświetlić listę wdrożonych zasobów w grupie zasobów.

az resource list --resource-group <ResourceGroupName>

Możesz również użyć witryny Azure Portal, aby wyświetlić listę zasobów:

  1. Zaloguj się w witrynie Azure Portal.
  2. W polu wyszukiwania wpisz App Configuration, a następnie wybierz z listy pozycję App Configuration.
  3. Wybierz nowo utworzony zasób App Configuration.
  4. W obszarze Operacje wybierz pozycję Eksplorator konfiguracji.
  5. Sprawdź, czy istnieją dwie wartości klucza.

Czyszczenie zasobów

Gdy grupa zasobów i jej zasoby nie będą już potrzebne, użyj interfejsu wiersza polecenia platformy Azure lub programu Azure PowerShell.

az group delete --name <ResourceGroupName>

Możesz również użyć witryny Azure Portal, aby usunąć grupę zasobów:

  1. Przejdź do grupy zasobów.
  2. Wybierz pozycję Usuń grupę zasobów.
  3. Pojawi się karta. Wprowadź nazwę grupy zasobów i wybierz pozycję Usuń.

Następne kroki

Aby dowiedzieć się, jak dodać flagę funkcji i odwołanie do usługi Key Vault do magazynu App Configuration, zapoznaj się z przykładami szablonów ARM.

  • Last updated on