Importera eller exportera konfigurationsdata

Azure App Configuration stöder åtgärder för dataimport och export. Använd dessa åtgärder för att arbeta med konfigurationsdata i bulk och utbyta data mellan ditt App Configuration store- och kodprojekt. Du kan till exempel konfigurera en App Configuration butik för testning och en annan för produktion. Du kan kopiera programinställningarna mellan dem så att du inte behöver ange data två gånger.

Den här artikeln innehåller en guide för att importera och exportera data med App Configuration. Om du vill konfigurera en pågående synkronisering med din GitHub-lagringsplats kan du ta en titt på GitHub Actions- och Azure Pipelines-uppgifter.

Du kan importera eller exportera data med hjälp av antingen Azure Portal eller Azure CLI.

Importera data

Import hämtar konfigurationsdata till ett App Configuration lager från en befintlig källa. Använd importfunktionen för att migrera data till en App Configuration lagra eller aggregera data från flera källor.

Den här guiden visar hur du importerar App Configuration data:

Importera data från en konfigurationsfil

Följ stegen nedan för att importera nyckelvärden från en fil.

Anteckning

Det går inte att importera funktionsflaggor från en fil. Om en konfigurationsfil innehåller funktionsflaggor importeras de automatiskt som vanliga nyckelvärden.

Från Azure Portal följer du dessa steg:

  1. Bläddra till din App Configuration butik och välj Importera/exporteraåtgärdsmenyn.

    Skärmbild av Azure Portal som importerar en fil.

  2. På fliken Importera väljer du Konfigurationsfil under Källtjänst.

  3. Fyll i formuläret med följande parametrar:

    Parameter Beskrivning Exempel
    För språk Välj språk för filen som du importerar mellan .NET, Java (Spring) och Other. .NET
    Filtyp Välj den typ av fil som du importerar mellan Yaml, Egenskaper och Json. Json
  4. Välj mappikonen och bläddra till filen som ska importeras.

    Anteckning

    Ett meddelande visas på skärmen som anger att filen har hämtats.

  5. Fyll i nästa del av formuläret:

    Parameter Beskrivning Exempel
    Avgränsare Avgränsaren är tecknet som parsas i den importerade konfigurationsfilen för att separera nyckelvärden som ska läggas till i konfigurationsarkivet. Välj något av följande alternativ: ., ,, :, ;, /, -, _, . ;
    Prefix Valfritt. Ett nyckelprefix är början på nyckelvärdets nyckelegenskap. Prefix kan användas för att hantera grupper av nyckelvärden i ett konfigurationslager. Det angivna prefixet läggs till framför egenskapen "nyckel" för varje nyckelvärde som du importerar från den här filen. TestApp:
    Etikett Valfritt. Välj en befintlig etikett eller ange en ny etikett som ska tilldelas dina importerade nyckelvärden. Art
    Innehållstyp Valfritt. Ange om du importerar en JSON-fil eller Key Vault referenser. Mer information om Key Vault referenser finns i Använda Key Vault referenser i en ASP.NET Core app. JSON (application/json)
  6. Välj Använd för att fortsätta med importen.

Du har importerat nyckelvärden från en JSON-fil, har tilldelat dem etiketten "prod" och prefixet "TestApp". Avgränsaren ":" används och alla nyckelvärden som du har importerat har innehållstypen inställd som "JSON".

Importera data från ett App Configuration lager

Du kan importera värden från en App Configuration store till en annan App Configuration store, eller importera värden från en App Configuration store till samma App Configuration store för att duplicera dess värden och tillämpa olika parametrar, till exempel ny etikett eller innehållstyp.

Följ stegen nedan för att importera nyckelvärden och funktionsflaggor från en Azure App Configuration store.

Från Azure Portal följer du dessa steg:

  1. Bläddra till din App Configuration butik och välj Importera/exporteraåtgärdsmenyn.

    Skärmbild av Azure Portal som importeras från en App Configuration butik.

  2. På fliken Importera väljer du App Configuration under Källtjänst.

  3. Välj Välj resurs, fyll i formuläret med följande parametrar och välj Använd:

    Parameter Beskrivning Exempel
    Prenumeration Din aktuella prenumeration är markerad som standard. my-subscription
    Resursgrupp Välj en resursgrupp som innehåller det App Configuration arkiv med konfiguration som ska importeras. Din aktuella resursgrupp är markerad som standard. my-resource-group
    Resurs Välj det App Configuration arkiv som innehåller den konfiguration som du vill importera. my-other-app-config-store

    Anteckning

    Meddelandet "Åtkomstnycklar har hämtats" anger att anslutningen till App Configuration store lyckades."

  4. Fyll i nästa del av formuläret:

    Parameter Beskrivning Exempel
    Från etikett Välj minst en etikett för att importera värden med motsvarande etiketter. Markera alla importerar nyckelvärden med valfri etikett och (Ingen etikett) begränsar importen till nyckelvärden utan etikett. Art
    Vid en viss tidpunkt Valfritt. Fyll i för att importera nyckelvärden från en viss tidpunkt. Det här är tidpunkten för nyckelvärdena i det valda konfigurationsarkivet. Format: "ÅÅÅÅ-MM-DDThh:mm:ssZ". Det här fältet är som standard den aktuella tidpunkten för nyckelvärdena när det lämnas tomt. 2022-07-28 12:00:00
    Åsidosätta standardetiketter för nyckel/värde Valfritt. Som standard använder importerade objekt sin aktuella etikett. Markera kryssrutan och ange en etikett för att åsidosätta dessa standardvärden med en anpassad etikett. Nya
    Åsidosätt standardinnehållstypen nyckelvärde Valfritt. Som standard använder importerade objekt sin aktuella innehållstyp. Markera kryssrutan och välj Key Vault Referens eller JSON (program/json) under Innehållstyp för att ange att det importerade innehållet består av en Key Vault referens eller en JSON-fil. Innehållstypen kan bara åsidosättas för importerade nyckelvärden. Standardinnehållstypen för funktionsflaggor är "application/vnd.microsoft.appconfig.ff+json;charset=utf-8" och uppdateras inte av den här parametern. JSON (application/json)
  5. Välj Använd för att fortsätta med importen.

Du har importerat nyckelvärden och funktionsflaggor med etiketten "prod" från ett App Configuration arkiv den 28 januari 2021 kl. 12.00 och har tilldelat dem etiketten "ny". Alla nyckelvärden som du har importerat har innehållstypen inställd som "JSON".

Importera data från Azure App Service

Följ stegen nedan för att importera nyckelvärden från Azure App Service.

Anteckning

App Service stöder för närvarande inte funktionsflaggor. Alla funktionsflaggor som importeras till App Service konverteras automatiskt till nyckelvärden. Dina App Service resurser kan bara innehålla nyckelvärden.

Från Azure-portalen:

  1. Bläddra till din App Configuration butik och välj Importera/exporteraåtgärdsmenyn.

    Skärmbild av Azure Portal som importeras från App Service.

  2. På fliken Importera väljer du App Services under Källtjänst.

  3. Välj Välj resurs, fyll i formuläret med följande parametrar och välj Använd:

    Parameter Beskrivning Exempel
    Prenumeration Din aktuella prenumeration är markerad som standard. my-subscription
    Resursgrupp Välj en resursgrupp som innehåller App Service med konfiguration som ska importeras. my-resource-group
    Resurs Välj den App Service som innehåller den konfiguration som du vill importera. my-app-service

    Anteckning

    Ett meddelande visas som anger antalet nyckelvärden som hämtades från källan App Service resursen.

  4. Fyll i nästa del av formuläret:

    Parameter Beskrivning Exempel
    Prefix Valfritt. Ett nyckelprefix är början av nyckelvärdenas nyckelegenskap. Prefix kan användas för att hantera grupper av nyckelvärden i ett konfigurationsarkiv. Det här prefixet läggs till på framsidan av nyckelegenskapen för varje importerat nyckelvärde. TestApp:
    Etikett Valfritt. Välj en befintlig etikett eller ange en ny etikett som ska tilldelas till dina importerade nyckelvärden. Art
    Innehållstyp Valfritt. Ange om filen du importerar är en Key Vault referens eller en JSON-fil. Mer information om Key Vault referenser finns i Använda Key Vault referenser i en ASP.NET Core app. JSON (application/json)
  5. Välj Använd för att fortsätta med importen.

Du har importerat alla programinställningar från en App Service som nyckelvärden och tilldelat dem etiketten "prod" och prefixet "TestApp". Alla nyckelvärden som du har importerat har en innehållstyp inställd som "JSON".

Exportera data

Exportera skriver konfigurationsdata som lagras i App Configuration till ett annat mål. Använd till exempel exportfunktionen för att spara data från ett App Configuration arkiv till en fil som kan bäddas in i programkoden under distributionen.

Den här guiden visar hur du exporterar App Configuration data:

Exportera data till en konfigurationsfil

Följ stegen nedan för att exportera konfigurationsdata från ett appkonfigurationsarkiv till en Json-, Yaml- eller properties-fil.

Anteckning

Export av funktionsflaggor från ett App Configuration arkiv till en konfigurationsfil stöds för närvarande endast i CLI.

Följ dessa steg från Azure Portal:

  1. Bläddra till App Configuration store och välj Importera/exportera.

    Skärmbild av Azure Portal som exporterar en fil

  2. På fliken Exportera väljer du Konfigurationsfil under Måltjänst.

  3. Fyll i formuläret med följande parametrar:

    Parameter Beskrivning Exempel
    Prefix Valfritt. Det här prefixet kommer att trimmas från varje nyckelvärdes "nyckel"-egenskap. Ett nyckelprefix är början av en nyckel. Prefix kan användas för att hantera grupper av nyckelvärden i ett konfigurationsarkiv. TestApp:
    Från etikett Välj en befintlig etikett för att begränsa exporten till nyckelvärden med en specifik etikett. Om du inte väljer en etikett exporteras som standard endast nyckelvärden med etiketten "Ingen etikett". Se anteckningen nedan. Art
    Vid en viss tidpunkt Valfritt. Fyll i för att importera nyckelvärden från en viss tidpunkt. Det här är tidpunkten för nyckelvärdena i det valda konfigurationsarkivet. Format: "ÅÅÅÅ-MM-DDThh:mm:ssZ". Det här fältet är som standard den aktuella tidpunkten för nyckelvärdena när det lämnas tomt. 2022-07-28 12:00:00
    Filtyp Välj den typ av fil som du exporterar mellan Yaml, Egenskaper eller Json. JSON
    Avgränsare Avgränsaren är avgränsaren för att platta ut nyckelvärdena till Json/Yaml. Den stöder konfigurationens hierarkiska struktur och gäller inte för egenskapsfiler och funktionsflaggor. Välj något av följande alternativ: ., ,, :, ;, /, , -_, eller (Ingen avgränsare). ;

    Viktigt

    Om du inte väljer en Från-etikett exporteras endast nyckelvärden utan etiketter. Om du vill exportera ett nyckelvärde med en etikett måste du välja dess etikett. Observera att du bara kan välja en etikett per export i portalen, om du vill exportera nyckelvärdena med alla angivna etiketter använder du CLI.

  4. Välj Exportera för att slutföra exporten.

Du har exporterat nyckelvärden som har "prod"-etiketten från en konfigurationsfil, i deras tillstånd från 2021-07-28 12:00:00 och har trimmat prefixet "TestApp". Värden avgränsas med ";" i filen.

Exportera data till ett App Configuration lager

Följ stegen nedan för att exportera nyckelvärden och funktionsflaggor till ett Azure App Configuration store.

Du kan exportera värden från en App Configuration store till en annan App Configuration store, eller exportera värden från en App Configuration store till samma App Configuration store för att duplicera dess värden och tillämpa olika parametrar, till exempel ny etikett eller innehållstyp.

Från Azure Portal följer du dessa steg:

  1. Bläddra till det App Configuration arkiv som innehåller de data som du vill exportera och välj Importera/exporteraåtgärdsmenyn.

    Skärmbild av Azure Portal som exporterar från en App Configuration butik.

  2. På fliken Exportera väljer du App Configuration under Måltjänst.

  3. Välj Välj resurs, fyll i formuläret med följande parametrar och välj Använd:

    Parameter Beskrivning Exempel
    Prenumeration Din aktuella prenumeration är markerad som standard. my-subscription
    Resursgrupp Välj en resursgrupp som innehåller det App Configuration arkiv med konfiguration som ska importeras. my-resource-group
    Resurs Välj det App Configuration arkiv som innehåller den konfiguration som du vill importera. my-app-config-store
  4. Sidan visar nu den valda måltjänsten och resurs-ID:t. Med åtgärden Välj resurs kan du växla till en annan källa App Configuration store.

    Anteckning

    Ett meddelande visas på skärmen som anger att nyckelvärdena har hämtats.

  5. Fyll i nästa del av formuläret:

    Parameter Beskrivning Exempel
    Från etikett Välj minst en etikett för att exportera värden med motsvarande etiketter. Markera alla exporterar nyckelvärden med valfri etikett och (Ingen etikett) begränsar exporten till nyckelvärden utan etikett. Art
    Vid en viss tidpunkt Valfritt. Fyll i för att importera nyckelvärden från en viss tidpunkt. Det här är tidpunkten för nyckelvärdena i det valda konfigurationsarkivet. Format: "ÅÅÅÅ-MM-DDThh:mm:ssZ". Det här fältet är som standard den aktuella tidpunkten för nyckelvärdena när det lämnas tomt. 2022-07-28 12:00:00
    Åsidosätta standardetiketter för nyckel/värde Valfritt. Som standard använder importerade objekt sin aktuella etikett. Markera kryssrutan och ange en etikett för att åsidosätta dessa standardvärden med en anpassad etikett. Nya
  6. Välj Använd för att fortsätta med exporten.

Du har exporterat nyckelvärden och funktionsflaggor som har etiketten "prod" från en App Configuration butik, i deras tillstånd från 2022-07-28 12:00:00 och har tilldelat dem etiketten "ny".

Exportera data till Azure App Service

Följ stegen nedan för att exportera nyckelvärden till Azure App Service.

Anteckning

Det finns för närvarande inte stöd för att exportera funktionsflaggor till App Service.

Följ dessa steg från Azure Portal:

  1. Bläddra till ditt App Configuration arkiv och välj Importera/exporteraåtgärdsmenyn.

    Skärmbild av Azure Portal som exporteras från App Service.

  2. På fliken Exportera väljer du App Services under Måltjänst.

  3. Välj Välj resurs, fyll i formuläret med följande parametrar och välj Tillämpa:

    Parameter Beskrivning Exempel
    Prenumeration Din aktuella prenumeration är markerad som standard. my-subscription
    Resursgrupp Välj en resursgrupp som innehåller App Service med konfiguration som ska exporteras. my-resource-group
    Resurs Välj den App Service som innehåller den konfiguration som du vill exportera. my-app-service
  4. Sidan visar nu den valda måltjänsten och resurs-ID:t. Med åtgärden Välj resurs kan du växla till ett annat mål App Service resurs.

  5. Du kan också fylla i nästa del av formuläret:

    Parameter Beskrivning Exempel
    Prefix Valfritt. Det här prefixet kommer att trimmas från varje exporterad nyckelvärdes nyckelegenskap. Ett nyckelprefix är början av en nyckel. Prefix kan användas för att hantera grupper av nyckelvärden i ett konfigurationsarkiv. Prefixet ignoreras för funktionsflaggor. TestApp:
    Exportera som referens Valfritt. Kontrollera om du vill exportera nyckelvärden till App Service som App Configuration referenser. Läs mer
    Vid en viss tidpunkt Valfritt. Fyll i för att exportera nyckelvärden från en viss tidpunkt. Det här är tidpunkten för nyckelvärdena i det valda konfigurationsarkivet. Format: "ÅÅÅÅ-MM-DDThh:mm:ssZ". Det här fältet använder som standard den aktuella tidpunkten för nyckelvärdena när det lämnas tomt. 07/28/2022 12:00:00
    Från etikett Valfritt. Välj en befintlig etikett för att begränsa exporten till nyckelvärden med en specifik etikett. Om du inte väljer en etikett exporteras endast nyckelvärden med etiketten "Ingen etikett". Art
  6. Välj Använd för att fortsätta med exporten.

Du har exporterat nyckelvärden som har etiketten "prod" från en App Service resurs i deras tillstånd från 2021-07-28 12:00:00 och har trimmat prefixet "TestApp". Nyckelvärdena har exporterats med en innehållstyp i JSON-format.

Om du markerar kryssrutan för att exportera nyckelvärden som referenser visas de exporterade nyckelvärdena som App Configuration referenser i kolumnen "Källa" i konfigurationsinställningarna för din App Service resurs.

Skärmbild av App Service konfigurationsinställningar. Exporterad App Configuration referens i App Service(Portal).

Felmeddelanden

Du kan stöta på följande felmeddelanden när du importerar eller exporterar App Configuration nyckelvärden:

  • Den markerade filen måste vara mellan 1 och 2097152 byte: filen är för stor. Välj en mindre fil.
  • Offentlig åtkomst är inaktiverad för ditt arkiv eller så kommer du åt från en privat slutpunkt som inte finns i butikens privata slutpunktskonfigurationer. Om du vill importera nyckelvärden från en App Configuration butik måste du ha åtkomst till det arkivet. Om det behövs aktiverar du offentlig åtkomst för källarkivet eller får åtkomst till det från en godkänd privat slutpunkt. Om du precis har aktiverat offentlig åtkomst väntar du upp till 5 minuter tills cacheminnet uppdateras.

Nästa steg