Delen via

Instellingen importeren in App Configuration met Azure Pipelines

  • Artikel

De Azure-app-taak Configuratie importeren importeert sleutelwaarden uit een configuratiebestand in uw App Configuration-archief. Met deze taak kunt u volledige cirkelfunctionaliteit in de pijplijn uitvoeren, omdat u nu instellingen uit het App Configuration-archief kunt exporteren en instellingen kunt importeren in het App Configuration-archief.

Vereisten

Een serviceverbinding maken

Met een serviceverbinding hebt u vanuit uw Azure DevOps-project toegang tot resources in uw Azure-abonnement.

  1. Ga in Azure DevOps naar het project dat uw doelpijplijn bevat. Selecteer projectinstellingen in de linkerbenedenhoek.

  2. Selecteer onder Pipelines de optie Serviceverbindingen. Selecteer in de rechterbovenhoek de optie Nieuwe serviceverbinding.

  3. Selecteer Azure Resource Manager in de nieuwe serviceverbinding.

    Schermopname van het selecteren van Azure Resource Manager in de vervolgkeuzelijst Nieuwe serviceverbinding.

  4. Selecteer in het dialoogvenster Verificatiemethode workloadidentiteitsfederatie (automatisch) om een nieuwe workloadidentiteitsfederatie te maken of selecteer workloadidentiteitsfederatie (handmatig) om een bestaande federatie van workloadidentiteit te gebruiken.

  5. Voer uw abonnement, resourcegroep en een naam in voor uw serviceverbinding.

Als u een nieuwe service-principal hebt gemaakt, zoekt u de naam van de service-principal die aan de serviceverbinding is toegewezen. In de volgende stap voegt u een nieuwe roltoewijzing toe aan deze service-principal.

  1. Ga naar Project Settings>Service-verbindingen.

  2. Selecteer de nieuwe serviceverbinding.

  3. Selecteer Service-principal beheren.

  4. Noteer de waarde in weergavenaam.

    Schermopname van de weergavenaam van de service-principal.

Roltoewijzing toevoegen

Wijs de juiste Roltoewijzingen voor App Configuration toe aan de referenties die in de taak worden gebruikt, zodat de taak toegang heeft tot het App Configuration-archief.

  1. Ga naar uw doel-App Configuration-archief.

  2. Selecteer toegangsbeheer (IAM) in het linkermenu.

  3. Selecteer Roltoewijzingen toevoegen in het rechterdeelvenster.

    Schermopname van de knop Roltoewijzingen toevoegen.

  4. Selecteer voor Rol de eigenaar van app-configuratiegegevens. Met deze rol kan de taak lezen van en schrijven naar het App Configuration-archief.

  5. Selecteer de service-principal die is gekoppeld aan de serviceverbinding die u in de vorige sectie hebt gemaakt.

    Schermopname van het dialoogvenster Roltoewijzing toevoegen.

  6. Selecteer Controleren + toewijzen.

Gebruiken in builds

In deze sectie wordt beschreven hoe u de taak Azure-app Configuratie importeren gebruikt in een Azure DevOps-buildpijplijn.

  1. Navigeer naar de pagina build-pijplijn door op Pipelines Pipelines> te klikken. Ga naar Uw eerste pijplijn maken voor meer informatie over build-pijplijnen.
    • Als u een nieuwe build-pijplijn maakt, selecteert u in de laatste stap van het proces op het tabblad Controleren de assistent Weergeven aan de rechterkant van de pijplijn.

      Schermopname van de knop Assistent weergeven voor een nieuwe pijplijn.

    • Als u een bestaande build-pijplijn gebruikt, klikt u op de knop Bewerken in de rechterbovenhoek.

      Schermopname van de knop Bewerken voor een bestaande pijplijn.

  2. Zoek de Azure-app configuratie importeren taak.

    Schermopname van het dialoogvenster Taak toevoegen met Azure-app Configuratie importeren in het zoekvak.

  3. Configureer de benodigde parameters voor de taak om sleutelwaarden uit het configuratiebestand te importeren in het App Configuration-archief. Uitleg van de parameters zijn beschikbaar in de sectie Parameters en in knopinfo naast elke parameter.

    Schermopname van de taakparameters voor het importeren van de app-configuratie.

  4. Een build opslaan en in de wachtrij plaatsen. In het buildlogboek worden eventuele fouten weergegeven die zijn opgetreden tijdens de uitvoering van de taak.

Gebruiken in releases

In deze sectie wordt beschreven hoe u de Azure-app Configuratie importeren-taak gebruikt in een Azure DevOps-releasepijplijn.

  1. Navigeer naar de release-pijplijnpagina door Pijplijnreleases> te selecteren. Ga naar Uw eerste release-pijplijn maken voor meer informatie over release-pijplijnen.
  2. Kies een bestaande release-pijplijn. Als u er nog geen hebt, selecteert u + Nieuw om een nieuwe te maken.
  3. Selecteer de knop Bewerken in de rechterbovenhoek om de release-pijplijn te bewerken.
  4. Kies in de vervolgkeuzelijst Taken de fase waaraan u de taak wilt toevoegen. Meer informatie over fasen vindt u in fasen, afhankelijkheden en voorwaarden toevoegen.

    Schermopname van de geselecteerde fase in de vervolgkeuzelijst Taken.

  5. Klik + naast de taak waaraan u een nieuwe taak wilt toevoegen.

    Schermopname van de plusknop naast de taak.

  6. Typ in het dialoogvenster Taken toevoegen Azure-app Configuratie importeren in het zoekvak en selecteer deze.
  7. Configureer de benodigde parameters binnen de taak om uw sleutelwaarden uit uw configuratiebestand te importeren in uw App Configuration-archief. Uitleg van de parameters zijn beschikbaar in de sectie Parameters en in knopinfo naast elke parameter.
  8. Sla een release op en plaats deze in de wachtrij. In het releaselogboek worden eventuele fouten weergegeven die zijn opgetreden tijdens de uitvoering van de taak.

Parameters

De volgende parameters worden gebruikt door de importtaak app-configuratie:

  • Azure-abonnement: een vervolgkeuzelijst met uw beschikbare Azure-serviceverbindingen. Als u uw lijst met beschikbare Azure-serviceverbindingen wilt bijwerken en vernieuwen, drukt u op de knop Azure-abonnement vernieuwen rechts van het tekstvak.
  • App Configuration-eindpunt: een vervolgkeuzelijst waarmee het beschikbare configuratiearchiefeindpunt wordt geladen onder het geselecteerde abonnement. Als u uw lijst met beschikbare configuratiearchieven wilt bijwerken en vernieuwen, drukt u op de knop App Configuration-eindpunt vernieuwen rechts van het tekstvak.
  • Pad naar configuratiebestand: het pad naar uw configuratiebestand. De parameter Configuratiebestandspad begint in de hoofdmap van de bestandsopslagplaats. U kunt door uw buildartefact bladeren om een configuratiebestand te selecteren. (... rechts van het tekstvak). De ondersteunde bestandsindelingen zijn afhankelijk van het bestandsinhoudsprofiel. Voor het standaardprofiel zijn de ondersteunde bestandsindelingen yaml, json en eigenschappen. Voor KvSet-profiel is de ondersteunde bestandsindeling json.
  • Bestandsinhoudsprofiel: het inhoudsprofiel van het configuratiebestand. De standaardwaarde is Standaard.
    • Standaard: verwijst naar de conventionele configuratiebestandsindelingen die rechtstreeks kunnen worden gebruikt door toepassingen.
    • Kvset: verwijst naar een bestandsschema dat alle eigenschappen van een App Configuration-sleutelwaarde bevat, waaronder sleutel, waarde, label, inhoudstype en tags. De taakparameters Scheidingsteken, Label, Inhoudstype, Voorvoegsel, Tags en Diepte zijn niet van toepassing wanneer u het Kvset-profiel gebruikt.
  • Importmodus: de standaardwaarde is Alles. Bepaalt het gedrag bij het importeren van sleutelwaarden.
    • Alle: Hiermee importeert u alle sleutelwaarden in het configuratiebestand naar App Configuration.
    • Ignore-Match: hiermee importeert u alleen instellingen die geen overeenkomende sleutelwaarde hebben in App Configuration. Overeenkomende sleutelwaarden worden beschouwd als sleutelwaarden met dezelfde sleutel, label, waarde, inhoudstype en tags.
  • Drooguitvoering: de standaardwaarde is uitgeschakeld.
    • Ingeschakeld: er worden geen updates uitgevoerd voor App Configuration. In plaats daarvan worden updates die in een normale uitvoering zouden zijn uitgevoerd, afgedrukt naar de console voor revisie.
    • Uitgeschakeld: voert updates uit voor App Configuration en wordt niet afgedrukt naar de console.
  • Scheidingsteken: het scheidingsteken dat wordt gebruikt voor het plat maken van .json en .yml bestanden.
  • Diepte: De diepte waarnaar de .json- en .yml-bestanden zijn afgevlakt.
  • Voorvoegsel: Een tekenreeks die is toegevoegd aan het begin van elke sleutel die is geïmporteerd in het App Configuration-archief.
  • Label: Een tekenreeks die is toegevoegd aan elke sleutelwaarde als het label in het App Configuration-archief.
  • Inhoudstype: Een tekenreeks die aan elke sleutelwaarde is toegevoegd als het inhoudstype in het App Configuration-archief.
  • Tags: Een JSON-object in de indeling van {"tag1":"val1", "tag2":"val2"}, waarmee tags worden gedefinieerd die worden toegevoegd aan elke sleutelwaarde die in uw App Configuration-archief wordt geïmporteerd.
  • Sleutelwaarden verwijderen die niet zijn opgenomen in het configuratiebestand: De standaardwaarde is uitgeschakeld. Het gedrag van deze optie is afhankelijk van het inhoudsprofiel van het configuratiebestand.
    • Ingeschakeld:
      • Standaardinhoudsprofiel: verwijdert alle sleutelwaarden in het App Configuration-archief die overeenkomen met zowel het opgegeven voorvoegsel als het label voordat u nieuwe sleutelwaarden uit het configuratiebestand importeert.
      • Kvset-inhoudsprofiel: verwijdert alle sleutelwaarden in het App Configuration-archief die niet zijn opgenomen in het configuratiebestand voordat u nieuwe sleutelwaarden uit het configuratiebestand importeert.
    • Uitgeschakeld: hiermee importeert u alle sleutelwaarden uit het configuratiebestand in het App Configuration-archief en blijft alles in het App Configuration-archief intact.

Probleemoplossing

Als er een onverwachte fout optreedt, kunnen foutopsporingslogboeken worden ingeschakeld door de pijplijnvariabele system.debug in te stellen op true.

Veelgestelde vragen

Hoe kan ik meerdere configuratiebestanden uploaden?

Als u meerdere configuratiebestanden wilt importeren in het App Configuration-archief, maakt u meerdere exemplaren van de taak Azure-app Configuratie importeren binnen dezelfde pijplijn.

Hoe kan ik Key Vault-verwijzingen of functievlagmen maken met behulp van deze taak?

Raadpleeg voorbeelden in de Azure-app Configuration-ondersteuning voor het configuratiebestand, afhankelijk van het profiel voor bestandsinhoud dat u hebt geselecteerd.

Waarom krijg ik een 409-fout bij het importeren van sleutelwaarden in mijn configuratiearchief?

Er treedt een foutbericht van 409 Conflict op als de taak probeert een sleutelwaarde te verwijderen of overschrijven die is vergrendeld in het App Configuration-archief.

Volgende stap

Raadpleeg het volgende document voor een volledig overzicht van de parameters of voor het gebruik van deze pijplijntaak in YAML-pijplijnen.

Azure-app Verwijzing naar importtaak voor configuratie

Als u wilt weten hoe u sleutelwaarden exporteert uit uw App Configuration-archief en deze instelt als Azure-pijplijnvariabelen, gaat u verder met het volgende document.

Instellingen exporteren uit App Configuration met Azure-pijplijnen

Als u wilt weten hoe u een momentopname maakt in een App Configuration-archief, gaat u verder met het volgende document.

Momentopnamen maken in App Configuration met Azure Pipelines