Bicep genereren met behulp van de functie samenstellen

De azure Developer CLI (azd) compose-functie vereenvoudigt het proces van het bouwen, implementeren en beheren van cloudtoepassingen. Met behulp van azd composekunt u de infrastructuur- en toepassingscode voor uw project op een uniforme manier definiëren en beheren. In deze handleiding wordt uitgelegd hoe u Bicep-code genereert op basis van de azd compose functie, zodat u uw cloudinfrastructuur kunt aanpassen aan uw specifieke vereisten.

Hoe azd compose de infrastructuurstatus beheert

De azd compose functie houdt uw infrastructuurstatus in het geheugen bij tijdens het samenstellingsproces. Met deze aanpak kunt u uw toepassing en infrastructuur iteratief definiëren en verfijnen zonder direct bestanden te genereren of de projectmap te wijzigen.

Wanneer u de azd infra synth opdracht uitvoert, wordt de status in het geheugen geconverteerd naar Bicep-bestanden in de infra map. Op dit moment wordt de status van de infrastructuur overgezet van het in-memory beheren tot weergeven als code, waardoor verdere aanpassingen mogelijk zijn.

Aanbeveling

Gebruik azd compose deze functie om snel een prototype te maken van uw infrastructuur voordat u wijzigingen op basis van bestanden doorvoert.azd infra synth

De Bicep-code genereren

Als u de Bicep-code wilt verkennen of aanpassen die intern door azd gebruikt wordt om resources te voorzien van azd add, voert u de volgende opdracht uit:

azd infra gen

Opmerking

De azd infra synth opdracht uit eerdere versies van azd is nu een alias van azd infra generateen blijft werken. Er wordt echter een waarschuwingsbericht weergegeven en de opdracht kan in een toekomstige azd release worden verwijderd.

Met deze opdracht worden de bijbehorende Bicep-bestanden in de infra map van uw app gegenereerd.

Updates beheren met Bicep-generatieproces

Wanneer u de azd infra gen opdracht uitvoert, sluit u de azd compose werkstroom en het vereenvoudigde init-proces af. Vanaf dit punt worden alle wijzigingen die u aanbrengt in de gegenereerde Bicep-bestanden niet meer bijgehouden door azd compose. Als u de Bicep-bestanden wijzigt en daarna azd infra gen opnieuw uitvoert, worden uw handmatige wijzigingen overschreven door de nieuw gegenereerde code.

Hier ziet u hoe een typische werkstroom eruit kan zien:

1. U gebruikt azd add om nieuwe Azure-resources aan uw project toe te voegen. Deze resources worden intern beheerd door azd.
2. Zodra u klaar bent met het toevoegen van resources, voert u de opdracht uit azd infra gen om Bicep-bestanden te genereren voor deze resources in de map van infra het project. In deze fase worden de resources niet meer beheerd door de azd compose werkstroom.
3. U kunt nu de Bicep-bestanden handmatig bijwerken terwijl u doorgaat met het ontwikkelen van uw app.
4. Als u meer resources toevoegt of opnieuw uitvoert azd infra gen , wordt de inhoud van de infra map opnieuw gegenereerd en gaan eventuele handmatige wijzigingen verloren.

Daarom is de functie opstellen het meest geschikt voor de volgende scenario's:

• Maak een eerste set Azure-resources voor uw project en beheer vervolgens zelf verdere updates door de Bicep-bestanden te bewerken.
• Uw Azure-resources volledig beheren via de opstelfunctie zonder uit te voeren azd infra gen.

Volgende stappen

Overzicht van Azure Developer CLI-sjablonen maken