Configuratiegegevens importeren of exporteren
Azure-app Configuration ondersteunt bewerkingen voor het importeren en exporteren van gegevens. Gebruik deze bewerkingen om bulksgewijs met configuratiegegevens te werken en gegevens uit te wisselen tussen uw App Configuration-archief en codeproject. U kunt bijvoorbeeld één App Configuration-archief instellen voor testen en een andere voor productie. U kunt toepassingsinstellingen ertussen kopiëren, zodat u geen gegevens tweemaal hoeft in te voeren.
Dit artikel bevat een handleiding voor het importeren en exporteren van gegevens met App Configuration. Als u een doorlopende synchronisatie met uw GitHub-opslagplaats wilt instellen, bekijkt u GitHub Actions en Azure Pipelines-taken.
U kunt gegevens importeren of exporteren met behulp van Azure Portal of de Azure CLI.
Gegevens importeren
Importeren brengt configuratiegegevens naar een App Configuration-archief van een bestaande bron. Gebruik de importfunctie om gegevens te migreren naar een App Configuration-archief of om gegevens uit meerdere bronnen samen te voegen.
Deze handleiding laat zien hoe u App Configuration-gegevens importeert:
- van een configuratiebestand in Json, Yaml of Eigenschappen
- vanuit een App Configuration-archief
- van Azure-app Service
Gegevens importeren uit een configuratiebestand
Volg de onderstaande stappen om sleutelwaarden uit een bestand te importeren.
Notitie
Het importeren van functievlagmen uit een bestand wordt niet ondersteund. Als een configuratiebestand functievlagmen bevat, worden ze automatisch als normale sleutelwaarden geïmporteerd.
Volg deze stappen vanuit de Microsoft Azure-portal:
Blader naar uw App Configuration-archief en selecteer Importeren/exporteren in het menu Operations .
Selecteer op het tabblad Importeren het configuratiebestand onder Bronservice.
Vul het formulier in met de volgende parameters:
Parameter Description Voorbeeld Voor taal Kies de taal van het bestand dat u importeert tussen .NET, Java (Spring) en Overige. .NET Bestandstype Selecteer het type bestand dat u importeert tussen Yaml, Eigenschappen en Json. Json Selecteer het mappictogram en blader naar het bestand dat u wilt importeren.
Notitie
Er wordt een bericht weergegeven op het scherm, waarmee wordt aangegeven dat het bestand is opgehaald.
Vul het volgende deel van het formulier in:
Parameter Description Voorbeeld Scheidingsteken Het scheidingsteken is het teken dat in het geïmporteerde configuratiebestand wordt geparseerd om sleutelwaarden te scheiden die worden toegevoegd aan het configuratiearchief. Selecteer een van de volgende opties: ., ,, :, ;, /, -_, —. ; Voorvoegsel Optioneel. Een sleutelvoorvoegsel is het begingedeelte van de eigenschap sleutelwaarde. Voorvoegsels kunnen worden gebruikt voor het beheren van groepen sleutelwaarden in een configuratiearchief. Het ingevoerde voorvoegsel wordt toegevoegd aan de voorzijde van de eigenschap 'sleutel' van elke sleutelwaarde die u uit dit bestand importeert. TestApp: Label Optioneel. Selecteer een bestaand label of voer een nieuw label in dat wordt toegewezen aan de geïmporteerde sleutelwaarden. prikkelen Inhoudstype Optioneel. Geef aan of u een JSON-bestand of Key Vault-verwijzingen importeert. Ga naar Key Vault-verwijzingen gebruiken in een ASP.NET Core-app voor meer informatie over Key Vault-verwijzingen. JSON (application/json) Selecteer Toepassen om door te gaan met het importeren.
U hebt sleutelwaarden geïmporteerd uit een JSON-bestand, het label prod en het voorvoegsel TestApp toegewezen. Het scheidingsteken ':' wordt gebruikt en alle sleutelwaarden die u hebt geïmporteerd, hebben inhoudstype ingesteld als JSON.
Gegevens importeren uit een App Configuration-archief
U kunt waarden uit het ene App Configuration-archief importeren naar een ander App Configuration-archief of u kunt waarden uit het ene App Configuration-archief importeren in hetzelfde App Configuration-archief om de waarden te dupliceren en verschillende parameters toe te passen, zoals een nieuw label of inhoudstype.
Volg de onderstaande stappen om sleutelwaarden en functievlagmen te importeren uit een Azure-app Configuratiearchief.
Volg deze stappen vanuit de Microsoft Azure-portal:
Blader naar uw App Configuration-archief en selecteer Importeren/exporteren in het menu Operations .
Selecteer op het tabblad Importeren de optie App Configuration onder Bronservice.
Selecteer Resource selecteren, vul het formulier in met de volgende parameters en selecteer Toepassen:
Parameter Description Voorbeeld Abonnement Uw huidige abonnement is standaard geselecteerd. mijn abonnement Resourcegroep Selecteer een resourcegroep die het App Configuration-archief bevat met de configuratie die u wilt importeren. Uw huidige resourcegroep is standaard geselecteerd. my-resource-group Bron Selecteer het App Configuration-archief dat de configuratie bevat die u wilt importeren. my-other-app-config-store Notitie
Het bericht 'Toegangssleutels opgehaald' geeft aan dat de verbinding met het App Configuration-archief is geslaagd.
Vul het volgende deel van het formulier in:
Parameter Description Voorbeeld Van label Selecteer ten minste één label om waarden met de bijbehorende labels te importeren. Selecteer alle importsleutelwaarden met een label en (Geen label) beperkt het importeren tot sleutelwaarden zonder label. prikkelen Op een bepaald tijdstip Optioneel. Vul in om sleutelwaarden te importeren vanaf een bepaald tijdstip. Dit is het tijdstip van de sleutelwaarden in het geselecteerde configuratiearchief. Notatie: "JJJJ-MM-DDThh:mm:ssZ". Dit veld wordt standaard ingesteld op het huidige tijdstip van de sleutelwaarden wanneer deze leeg blijft. 28-07-2022 12:00:00 uur Standaardlabels voor sleutelwaarden overschrijven Optioneel. Geïmporteerde items gebruiken standaard hun huidige label. Schakel het selectievakje in en voer een label in om deze standaardwaarden te overschrijven met een aangepast label. Nieuw Standaardinhoudstype sleutelwaarde overschrijven Optioneel. Geïmporteerde items gebruiken standaard hun huidige inhoudstype. Schakel het selectievakje in en selecteer Key Vault-verwijzing of JSON (toepassing/json) onder Inhoudstype om aan te geven dat de geïmporteerde inhoud bestaat uit een Key Vault-verwijzing of een JSON-bestand. Inhoudstype kan alleen worden overschreven voor geïmporteerde sleutelwaarden. Standaardinhoudstype voor functievlagmen is 'application/vnd.microsoft.appconfig.ff+json; charset=utf-8' en wordt niet bijgewerkt door deze parameter. JSON (application/json) Selecteer Toepassen om door te gaan met het importeren.
U hebt sleutelwaarden en functievlagmen geïmporteerd met het label prod uit een App Configuration-archief op 28 januari 2021 om 12:00 uur en het label 'nieuw' toegewezen. Alle sleutelwaarden die u hebt geïmporteerd, zijn ingesteld als 'JSON'.
Gegevens importeren uit Azure-app Service
Volg de onderstaande stappen om sleutelwaarden te importeren uit Azure-app Service.
Notitie
App Service biedt momenteel geen ondersteuning voor functievlagmen. Alle functievlagmen die in App Service worden geïmporteerd, worden automatisch geconverteerd naar sleutelwaarden. Uw App Service-resources kunnen alleen sleutelwaarden bevatten.
Vanuit de Azure-portal:
Blader naar uw App Configuration-archief en selecteer Importeren/exporteren in het menu Operations .
Selecteer App Services onder Bronservice op het tabblad Importeren.
Selecteer Resource selecteren, vul het formulier in met de volgende parameters en selecteer Toepassen:
Parameter Description Voorbeeld Abonnement Uw huidige abonnement is standaard geselecteerd. mijn abonnement Resourcegroep Selecteer een resourcegroep die de App Service bevat met de configuratie die u wilt importeren. my-resource-group Bron Selecteer de App Service die de configuratie bevat die u wilt importeren. my-app-service Notitie
Er wordt een bericht weergegeven dat het aantal sleutelwaarden aangeeft dat is opgehaald uit de Bron-App Service-resource.
Vul het volgende deel van het formulier in:
Parameter Description Voorbeeld Voorvoegsel Optioneel. Een sleutelvoorvoegsel is het begingedeelte van de eigenschap 'sleutel' van een sleutelwaarde. Voorvoegsels kunnen worden gebruikt voor het beheren van groepen sleutelwaarden in een configuratiearchief. Dit voorvoegsel wordt toegevoegd aan de voorzijde van de eigenschap 'sleutel' van elke geïmporteerde sleutelwaarde. TestApp: Label Optioneel. Selecteer een bestaand label of voer een nieuw label in dat wordt toegewezen aan de geïmporteerde sleutelwaarden. prikkelen Inhoudstype Optioneel. Geef aan of het bestand dat u importeert een Key Vault-verwijzing of een JSON-bestand is. Ga naar Key Vault-verwijzingen gebruiken in een ASP.NET Core-app voor meer informatie over Key Vault-verwijzingen. JSON (application/json) Selecteer Toepassen om door te gaan met het importeren.
U hebt alle toepassingsinstellingen uit een App Service geïmporteerd als sleutelwaarden en het label prod en het voorvoegsel TestApp toegewezen. Alle sleutelwaarden die u hebt geïmporteerd, zijn ingesteld als 'JSON'.
Gegevens exporteren
Exporteer schrijfconfiguratiegegevens die zijn opgeslagen in App Configuration naar een andere bestemming. Gebruik de exportfunctie bijvoorbeeld om gegevens uit een App Configuration-archief op te slaan in een bestand dat tijdens de implementatie kan worden ingesloten in uw toepassingscode.
In deze handleiding ziet u hoe u App Configuration-gegevens exporteert:
- naar een configuratiebestand in Json, Yaml of Eigenschappen
- naar een App Configuration-archief
- naar een Azure-app Service-resource
Gegevens exporteren naar een configuratiebestand
Volg de onderstaande stappen om configuratiegegevens uit een app-configuratiearchief te exporteren naar een Json-, Yaml- of Eigenschappenbestand.
Notitie
Het exporteren van functievlagmen vanuit een App Configuration-archief naar een configuratiebestand wordt momenteel alleen ondersteund in de CLI.
Voer vanuit Azure Portal de volgende stappen uit:
Blader naar uw App Configuration-archief en selecteer Importeren/exporteren.
Selecteer op het tabblad Exporteren het configuratiebestand onder Doelservice.
Vul het formulier in met de volgende parameters:
Parameter Description Voorbeeld Voorvoegsel Optioneel. Dit voorvoegsel wordt afgekapt van de eigenschap 'sleutel' van elke sleutelwaarde. Een sleutelvoorvoegsel is het begingedeelte van een sleutel. Voorvoegsels kunnen worden gebruikt voor het beheren van groepen sleutelwaarden in een configuratiearchief. TestApp: Van label Selecteer een bestaand label om uw export naar sleutelwaarden met een specifiek label te beperken. Als u geen label selecteert, worden standaard alleen sleutelwaarden met het label 'Geen label' geëxporteerd. Zie de opmerking hieronder. prikkelen Op een bepaald tijdstip Optioneel. Vul in om sleutelwaarden te importeren vanaf een bepaald tijdstip. Dit is het tijdstip van de sleutelwaarden in het geselecteerde configuratiearchief. Notatie: "JJJJ-MM-DDThh:mm:ssZ". Dit veld wordt standaard ingesteld op het huidige tijdstip van de sleutelwaarden wanneer deze leeg blijft. 28-07-2022 12:00:00 uur Bestandstype Selecteer het type bestand dat u exporteert tussen Yaml, Eigenschappen of Json. JSON Scheidingsteken Het scheidingsteken is het scheidingsteken voor het platmaken van de sleutelwaarden in Json/Yaml. Het ondersteunt de hiërarchische structuur van de configuratie en is niet van toepassing op eigenschapsbestanden en functievlagmen. Selecteer een van de volgende opties: ., ,, :, ;, /, -_, — of (Geen scheidingsteken). ; Belangrijk
Als u geen From-label selecteert, worden alleen sleutelwaarden zonder labels geëxporteerd. Als u een sleutelwaarde met een label wilt exporteren, moet u het label selecteren. Houd er rekening mee dat u slechts één label per export in de portal kunt selecteren voor het geval u de sleutelwaarden wilt exporteren met alle opgegeven labels, gebruikt u CLI.
Selecteer Exporteren om de export te voltooien.
U hebt sleutelwaarden geëxporteerd met het label 'prod' uit een configuratiebestand, op hun status van 28-07-2021 12:00:00 uur en het voorvoegsel 'TestApp' bijgesneden. Waarden worden gescheiden door ';' in het bestand.
Gegevens exporteren naar een App Configuration-archief
Volg de onderstaande stappen om sleutelwaarden en functievlagmen te exporteren naar een Azure-app Configuratiearchief.
U kunt waarden exporteren uit het ene App Configuration-archief naar een ander App Configuration-archief of u kunt waarden exporteren uit het ene App Configuration-archief naar hetzelfde App Configuration-archief om de waarden te dupliceren en verschillende parameters toe te passen, zoals een nieuw label of inhoudstype.
Volg deze stappen vanuit de Microsoft Azure-portal:
Blader naar het App Configuration-archief met de gegevens die u wilt exporteren en selecteer Importeren/exporteren in het menu Operations .
Selecteer op het tabblad Exporteren de optie App Configuration onder Doelservice.
Selecteer Resource selecteren, vul het formulier in met de volgende parameters en selecteer Toepassen:
Parameter Description Voorbeeld Abonnement Uw huidige abonnement is standaard geselecteerd. mijn abonnement Resourcegroep Selecteer een resourcegroep die het App Configuration-archief bevat met de configuratie die u wilt importeren. my-resource-group Bron Selecteer het App Configuration-archief dat de configuratie bevat die u wilt importeren. my-app-config-store Op de pagina worden nu de geselecteerde doelservice en resource-id weergegeven. Met de actie Resource selecteren kunt u overschakelen naar een ander bron-App Configuration-archief.
Notitie
Er wordt een bericht weergegeven op het scherm, waarmee wordt aangegeven dat de sleutelwaarden zijn opgehaald.
Vul het volgende deel van het formulier in:
Parameter Description Voorbeeld Van label Selecteer ten minste één label om waarden met de bijbehorende labels te exporteren. Selecteer alle sleutelwaarden met een label en (Geen label) beperkt de export naar sleutelwaarden zonder label. prikkelen Op een bepaald tijdstip Optioneel. Vul in om sleutelwaarden te importeren vanaf een bepaald tijdstip. Dit is het tijdstip van de sleutelwaarden in het geselecteerde configuratiearchief. Notatie: "JJJJ-MM-DDThh:mm:ssZ". Dit veld wordt standaard ingesteld op het huidige tijdstip van de sleutelwaarden wanneer deze leeg blijft. 28-07-2022 12:00:00 uur Standaardlabels voor sleutelwaarden overschrijven Optioneel. Geïmporteerde items gebruiken standaard hun huidige label. Schakel het selectievakje in en voer een label in om deze standaardwaarden te overschrijven met een aangepast label. Nieuw Selecteer Toepassen om door te gaan met de export.
U hebt sleutelwaarden en functievlagmen geëxporteerd met het label 'prod' uit een App Configuration-archief, op hun status vanaf 28-07-2022 12:00:00 uur en het label 'nieuw' toegewezen.
Gegevens exporteren naar Azure-app Service
Volg de onderstaande stappen om sleutelwaarden te exporteren naar Azure-app Service.
Notitie
Het exporteren van functievlagmen naar App Service wordt momenteel niet ondersteund.
Volg deze stappen vanuit de Microsoft Azure-portal:
Blader naar uw App Configuration-archief en selecteer Importeren/exporteren in het menu Operations .
Selecteer App Services onder Doelservice op het tabblad Exporteren.
Selecteer Resource selecteren, vul het formulier in met de volgende parameters en selecteer Toepassen:
Parameter Description Voorbeeld Abonnement Uw huidige abonnement is standaard geselecteerd. mijn abonnement Resourcegroep Selecteer een resourcegroep die de App Service bevat met de configuratie die u wilt exporteren. my-resource-group Bron Selecteer de App Service die de configuratie bevat die u wilt exporteren. my-app-service Op de pagina worden nu de geselecteerde doelservice en resource-id weergegeven. Met de actie Resource selecteren kunt u overschakelen naar een andere App Service-doelresource.
Vul desgewenst het volgende deel van het formulier in:
Parameter Description Voorbeeld Voorvoegsel Optioneel. Dit voorvoegsel wordt bijgesneden uit de eigenschap sleutelwaarde van elke geëxporteerde sleutelwaarde. Een sleutelvoorvoegsel is het begingedeelte van een sleutel. Voorvoegsels kunnen worden gebruikt voor het beheren van groepen sleutelwaarden in een configuratiearchief. Het voorvoegsel wordt genegeerd voor functievlagmen. TestApp: Exporteren als referentie Optioneel. Controleer of u sleutelwaarden naar App Service wilt exporteren als App Configuration-verwijzingen. Meer informatie Op een bepaald tijdstip Optioneel. Vul in om sleutelwaarden te exporteren vanaf een bepaald tijdstip. Dit is het tijdstip van de sleutelwaarden in het geselecteerde configuratiearchief. Notatie: "JJJJ-MM-DDThh:mm:ssZ". Dit veld wordt standaard ingesteld op het huidige tijdstip van de sleutelwaarden wanneer deze leeg blijft. 28-07-2022 12:00:00 uur Van label Optioneel. Selecteer een bestaand label om uw export naar sleutelwaarden met een specifiek label te beperken. Als u geen label selecteert, worden alleen sleutelwaarden met het label 'Geen label' geëxporteerd. prikkelen Selecteer Toepassen om door te gaan met de export.
U hebt sleutelwaarden geëxporteerd met het label prod uit een App Service-resource, op hun status vanaf 28-07-2021 12:00:00 uur en het voorvoegsel 'TestApp' bijgesneden. De sleutelwaarden zijn geëxporteerd met een inhoudstype in JSON-indeling.
Als u het selectievakje voor het exporteren van sleutelwaarden als verwijzingen hebt ingeschakeld, worden de geëxporteerde sleutelwaarden aangegeven als App Configuration-verwijzingen in de kolom Bron van de configuratie-instellingen van uw App Service-resource.
Foutberichten
Er kunnen de volgende foutberichten optreden bij het importeren of exporteren van sleutelwaarden voor App Configuration:
- Het geselecteerde bestand moet tussen 1 en 2097152 bytes zijn. Het bestand is te groot. Selecteer een kleiner bestand.
- Openbare toegang is uitgeschakeld voor uw winkel of u hebt toegang vanaf een privé-eindpunt dat zich niet in de configuraties van het privé-eindpunt van het archief bevindt. Als u sleutelwaarden uit een App Configuration-archief wilt importeren, moet u toegang hebben tot dat archief. Schakel zo nodig openbare toegang in voor het bronarchief of open deze vanuit een goedgekeurd privé-eindpunt. Als u zojuist openbare toegang hebt ingeschakeld, wacht u maximaal 5 minuten totdat de cache is vernieuwd.
Volgende stappen
Feedback
https://aka.ms/ContentUserFeedback.
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. Zie voor meer informatie:Feedback verzenden en weergeven voor