Training
Certificering
Microsoft Certified: Basisinformatie over Azure-gegevens - Certifications
Basiskennis demonstreren van basisgegevensconcepten met betrekking tot Microsoft Azure-gegevensservices.
Deze browser wordt niet meer ondersteund.
Upgrade naar Microsoft Edge om te profiteren van de nieuwste functies, beveiligingsupdates en technische ondersteuning.
Bestanden zijn een van de meest voorkomende manieren om configuratiegegevens op te slaan. App Configuration biedt hulpprogramma's om u te helpen bij het importeren van uw configuratiebestanden, zodat u uw gegevens niet handmatig hoeft in te voeren. Deze bewerking is een eenmalige gegevensmigratie als u van plan bent om uw gegevens in App Configuration te beheren nadat u ze hebt geïmporteerd. In sommige andere gevallen, bijvoorbeeld wanneer u configuratie als code gebruikt, kunt u uw configuratiegegevens blijven beheren in bestanden en ze importeren als onderdeel van uw CI/CD-proces. Mogelijk is een van deze twee scenario's van toepassing op u:
In de rest van dit document worden zowel bestandsinhoudsprofielen in detail besproken als gebruik van Azure CLI als voorbeeld. Hetzelfde concept is ook van toepassing op andere hulpprogramma's voor het importeren van App Configuration.
Het standaardbestandsinhoudsprofiel in App Configuration-hulpprogramma's verwijst naar het conventionele configuratiebestandsschema dat veel wordt gebruikt door bestaande programmeerframeworks of systemen. App Configuration biedt ondersteuning voor JSON-, YAML- of Eigenschappen-bestandsindelingen.
Het volgende voorbeeld is een configuratiebestand met appsettings.json
één configuratie-instelling en één functievlag.
{
"Logging": {
"LogLevel": {
"Default": "Warning"
}
},
"FeatureManagement": {
"Beta": false
}
}
Voer de volgende CLI-opdracht uit om deze te importeren in App Configuration met het dev
label en gebruik de dubbele punt (:
) als scheidingsteken om de sleutelnaam plat te maken. U kunt eventueel de parameter '--profile appconfig/default' toevoegen. Deze wordt overgeslagen in het voorbeeld omdat dit de standaardwaarde is.
az appconfig kv import --label dev --separator : --name <your store name> --source file --path appsettings.json --format json
Key Vault-verwijzingen vereisen een bepaald inhoudstype tijdens het importeren, zodat u ze in een afzonderlijk bestand bewaart. Het volgende voorbeeld is een bestand met de naam keyvault-refs.json
.
{
"Database:ConnectionString": {
"uri": "https://<your-vault-name>.vault.azure.net/secrets/db-secret"
}
}
Voer de volgende CLI-opdracht uit om deze te importeren met het test
label en het key vault-verwijzingstype.
az appconfig kv import --label test --content-type "application/vnd.microsoft.appconfig.keyvaultref+json;charset=utf-8" --name <your store name> --source file --path keyvault-refs.json --format json
In de volgende tabel ziet u alle geïmporteerde gegevens in uw App Configuration-archief.
Sleutel | Waarde | Label | Inhoudstype |
---|---|---|---|
.appconfig.featureflag/Beta | {"id":"Beta","description":"","enabled": false,"conditions":{"client_filters":[]}} | Dev | application/vnd.microsoft.appconfig.ff+json; charset=utf-8 |
Logboekregistratie:LogLevel:Default | Waarschuwing | Dev | |
Database:ConnectionString | {"uri":"https://< your-vault-name.vault.azure.net/secrets/db-secret>"} | test | application/vnd.microsoft.appconfig.keyvaultref+json; charset=utf-8 |
Het KVSet-bestandsinhoudsprofiel in App Configuration-hulpprogramma's verwijst naar een bestandsschema dat alle eigenschappen van een App Configuration-sleutelwaarde bevat, inclusief sleutel, waarde, label, inhoudstype en tags. Het bestand heeft de JSON-indeling. Zie het KVSet-bestandsschema voor de schemaspecificatie.
Het volgende voorbeeld is een bestand dat is gebaseerd op het KVSet-bestandsinhoudsprofiel met de naam appconfigdata.json
, met een functievlag, een Key Vault-verwijzing en een normale sleutelwaarde.
{
"items": [
{
"key": ".appconfig.featureflag/Beta",
"value": "{\"id\":\"Beta\",\"description\":\"Beta feature\",\"enabled\":true,\"conditions\":{\"client_filters\":[]}}",
"label": "dev",
"content_type": "application/vnd.microsoft.appconfig.ff+json;charset=utf-8",
"tags": {}
},
{
"key": "Database:ConnectionString",
"value": "{\"uri\":\"https://<your-vault-name>.vault.azure.net/secrets/db-secret\"}",
"label": "test",
"content_type": "application/vnd.microsoft.appconfig.keyvaultref+json;charset=utf-8",
"tags": {}
},
{
"key": "Logging:LogLevel:Default",
"value": "Debug",
"label": "dev",
"content_type": null,
"tags": {}
}
]
}
Tip
Als u het voorbeeld in de vorige sectie hebt gevolgd en de gegevens in uw App Configuration-archief hebt opgeslagen, kunt u deze exporteren naar een bestand met behulp van de CLI-opdracht:
Azure CLI
az appconfig kv export --profile appconfig/kvset --label * --name <your store name> --destination file --path appconfigdata.json --format json
Nadat het bestand is geëxporteerd, werkt u de eigenschap van de
Beta
functievlagenabled
bij intrue
en wijzigt u deLogging:LogLevel:Default
eigenschap inDebug
.
Voer de volgende CLI-opdracht uit met de parameter '--profile appconfig/kvset' om het bestand te importeren in uw App Configuration-archief. U hoeft geen regels voor gegevenstransformatie op te geven, zoals scheidingsteken, label of inhoudstype, zoals u hebt gedaan in de sectie standaardbestandsinhoudsprofiel, omdat alle informatie al in het bestand staat.
az appconfig kv import --profile appconfig/kvset --name <your store name> --source file --path appconfigdata.json --format json
Notitie
Het KVSet-bestandsinhoudsprofiel wordt momenteel ondersteund in
In de volgende tabel ziet u alle geïmporteerde gegevens in uw App Configuration-archief.
Sleutel | Waarde | Label | Inhoudstype |
---|---|---|---|
.appconfig.featureflag/Beta | {"id":"Beta","description":"Beta feature","enabled":true,"conditions":{"client_filters":[]}} | Dev | application/vnd.microsoft.appconfig.ff+json; charset=utf-8 |
Logboekregistratie:LogLevel:Default | Fouten opsporen | Dev | |
Database:ConnectionString | {"uri":"https://< your-vault-name.vault.azure.net/secrets/db-secret>"} | test | application/vnd.microsoft.appconfig.keyvaultref+json; charset=utf-8 |
Training
Certificering
Microsoft Certified: Basisinformatie over Azure-gegevens - Certifications
Basiskennis demonstreren van basisgegevensconcepten met betrekking tot Microsoft Azure-gegevensservices.
Documentatie
aanbevolen procedures voor Azure-app configuratie
Meer informatie over aanbevolen procedures tijdens het gebruik van Azure-app-configuratie. Onderwerpen die worden behandeld, zijn sleutelgroeperingen, sleutel-waardesamenstellingen, Bootstrap voor App Configuration en meer.
Gebruik labels om configuratiewaarden per omgeving op te geven. - Azure App Configuration
In dit artikel wordt beschreven hoe u labels gebruikt om app-configuratiewaarden op te halen voor de omgeving waarin de app momenteel wordt uitgevoerd.
Veelgestelde vragen over Azure-app configuratie
Lees antwoorden op veelgestelde vragen (FAQ) over Azure-app Configuratie, zoals hoe deze verschilt van Azure Key Vault.