Udostępnij za pośrednictwem

Szybki start: tworzenie magazynu konfiguracji aplikacja systemu Azure przy użyciu Bicep

  • Artykuł

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

  • Wdrażanie magazynu usługi App Configuration.
  • Utwórz wartości kluczy w magazynie usługi App Configuration.
  • Odczytywanie wartości klucz-wartość w magazynie usługi 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 aplikacja systemu Azure Configuration przy użyciu pliku Bicep wymaga roli usługi Azure Resource Manager, takiej jak współautor lub właściciel. Uzyskiwanie dostępu do danych konfiguracji aplikacja systemu Azure (klucz-wartości, migawki) wymaga roli usługi Azure Resource Manager i dodatkowej roli płaszczyzny danych konfiguracji aplikacja systemu Azure Konfiguracji, gdy tryb uwierzytelniania usługi ARM magazynu konfiguracji jest ustawiony na tryb uwierzytelniania przekazywanego usługi ARM.

Ważne

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

Przejrzyj plik Bicep

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

Uwaga

Pliki Bicep używają tego samego aparatu bazowego co szablony usługi ARM. Wszystkie porady, uwagi i ważne informacje zawarte w przewodniku Szybki start dotyczącym szablonu usługi ARM są stosowane tutaj. 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ę.

Wdrażanie pliku 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.

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

    Uwaga

    Zastąp <ciąg store-name nazwą> magazynu App Configuration.

    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 exampleRG

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 wprowadź ciąg App Configuration, a następnie wybierz pozycję App Configuration z listy.
  3. Wybierz nowo utworzony zasób usługi 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 exampleRG

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. Zostanie wyświetlona karta. Wprowadź nazwę grupy zasobów i wybierz pozycję Usuń.

Następne kroki

Aby dowiedzieć się więcej na temat dodawania flagi funkcji i odwołania usługi Key Vault do magazynu usługi App Configuration, zapoznaj się z przykładami szablonów usługi ARM.