Azure: Overzicht maken van CLI-sjablonen voor ontwikkelaars

De Azure Developer CLI (azd) maakt gebruik van templates voor het inrichten en implementeren van app-resources in de cloud. Ontwikkelaars kunnen ondersteuning voor azd opdrachten en functies toevoegen door hun toepassingen te converteren naar sjablonen. Dit artikel bevat een contextueel overzicht van de verschillende opties voor het bouwen azd van sjablonen. Zodra u de concepten in dit artikel begrijpt, gaat u naar de volgende bronnen voor gedetailleerdere implementatiehandleidingen:

• Gebruik een bestaande sjabloon voor uw app.
• Een sjabloon maken op basis van uw app-code
• Training: sjablonen bouwen en implementeren azd

Concepten voor het maken van sjablonen

Voor het maken van een azd sjabloon moet u specifieke configuratie- en infrastructuurassets toevoegen aan uw bestaande codebasis of een nieuwe app starten vanuit een bestaande sjabloon met diezelfde assets. Beide werkstromen worden in latere secties uitgelegd. Alle azd sjablonen delen een vergelijkbare bestandsstructuur op azd basis van conventies. In het volgende diagram ziet u een kort overzicht van het proces voor het maken van een azd sjabloon:

Voor elke azd sjabloon zijn de volgende minimale resources vereist:

• Een map infra die de infrastructuur als codebestanden (Bicep of Terraform) bevat.
• Een azure.yaml configuratiebestand waarmee uw toepassingsservices worden toegewezen aan de ingerichte infrastructuurbronnen.

Andere optionele mappen zijn vaak ook opgenomen, zoals een .github map met assets om een CI/CD-pijplijn te maken. Ga naar het overzichtsdocument voor meer informatie over sjablonen.

Bekijk de volgende voorbeeld-app-opslagplaats:

Nadat u deze voorbeeld-app naar een azd sjabloon hebt geconverteerd, bevat dezelfde app-opslagplaats het volgende:

De oorspronkelijke app-resources zijn ongewijzigd, maar er zijn nieuwe assets toegevoegd die azd afhankelijk zijn van opdrachten zoals azd up:

• Er is een map infra toegevoegd met Bicep bestanden om Azure resources te maken.
• Er is een azure.yaml-configuratiebestand toegevoegd om de app-code toe te koppelen aan de map src voor het toewijzen van Azure resources.
• Er is een .azure map gemaakt voor het opslaan azd van omgevingsvariabelen.
• Er is een .github map (optioneel) toegevoegd ter ondersteuning van CI/CD-pijplijnen via GitHub acties.

Werkstromen voor het maken van sjablonen

De opdracht azd init wordt gebruikt om een azd-sjabloon te initialiseren voor het inrichten en implementeren van de app-resources op Azure. Met de opdracht wordt u gevraagd om te kiezen tussen twee verschillende werkstromen om een sjabloon te initialiseren die wordt beschreven in de volgende secties: code gebruiken in de huidige map en een bestaande sjabloon gebruiken.

Voer de azd init opdracht uit in de hoofdmap van de map die u wilt converteren naar een azd template:

azd init

Code gebruiken in de huidige map

Met deze optie wordt azd gebruikt om de code in uw directory te analyseren en vast te stellen welke technologieën worden gebruikt, zoals de programmeertaal, het framework en het databasesysteem. azd genereert automatisch sjabloonassets voor u, zoals het azure.yaml servicedefinitiebestand en de infra map met infrastructuur als codebestanden. De gegenereerde assets zijn een uitgangspunt voor aanvullende wijzigingen. Gebruik deze methode als u van plan bent om algemene Azure-services te gebruiken die worden ondersteund door azd functies voor scaffolding.

Ga naar de Start met uw app-code om een sjabloon te maken zelfstudie voor meer informatie over het implementeren van deze benadering en meer informatie over welke Azure resources ondersteuning bieden voor automatische detectie en scaffolding.

Een sjabloon selecteren

Selecteer deze optie als u een bestaande sjabloon wilt gebruiken waarmee veel van uw Azure resources en architectuurdoelen als uitgangspunt worden gedefinieerd. azd u wordt gevraagd om een starterssjabloon of een andere sjabloon te selecteren in de awesome-azd gallery. Wanneer u een sjabloon selecteert, worden de assets van die sjabloon toegevoegd aan uw bestaande projectmap die u als uitgangspunt wilt gebruiken. Sommige sjablonen bevatten voorbeeld-app-code die u kunt vervangen door uw eigen code, terwijl sommige ('startersjablonen') alleen infrastructuur zijn.

Gebruik de azd init opdracht om een bestaande sjabloon op te halen naar een lege map en deze te gebruiken als uitgangspunt voor uw eigen app. Als de sjabloon de broncode van de app bevat, kunt u deze code afbouwen of de broncodemap vervangen door uw eigen map.

Ga naar de zelfstudie Aan de slag met een bestaande sjabloon voor meer informatie over het implementeren van deze benadering.

Zie ook

• Gebruik een bestaande sjabloon voor uw app.
• Een sjabloon maken op basis van uw app-code

Hulp vragen

Ga naar de pagina roubleshooting en ondersteuning voor informatie over het indienen van een bug, hulp vragen of een nieuwe functie voorstellen voor de Azure Developer CLI.

Volgende stappen