De sjabloonstructuur maken

  • 6 minuten

De Azure Developer CLI (azd) helpt u bij het bouwen van nieuwe sjablonen voor uw apps met behulp van de azd init opdracht- en starterssjablonen. In deze les maakt u de basisstructuur of de basisstructuur van een nieuwe sjabloon waarop u voor de rest van de module bouwt.

  1. Voer de azd init opdracht uit in een lege map op uw lokale computer.

    azd init

  2. In de uitvoer van de opdracht wordt een lijst met starterssjablonen en volledige voorbeeld-app-opties weergegeven. De starterssjablonen bevatten de essentiële mapstructuur, starterinfrastructuur als codebestanden en andere standaardconfiguratiebestanden om aan de slag te gaan met het bouwen van sjablonen. De volledige voorbeeldsjablonen bevatten ook tijdelijke toepassingscode en de bestanden die nodig zijn om ze te implementeren. Voor deze module leert u hoe u uw eigen sjabloon bouwt in plaats van bestaande app-code te wijzigen. Kies daarom de optie Starter - Bicep in de lijst. De Azure Developer CLI biedt ook ondersteuning voor het gebruik van Terraform als u die optie wilt gebruiken. Terraform-ondersteuning is momenteel in alfa en moet handmatig worden ingeschakeld.

  3. Wanneer u wordt gevraagd om een omgevingsnaam, voert u azdlearn of een naam van uw keuze in. De omgevingsnaam heeft invloed op de naamgeving van ingerichte resources in Azure.

  4. Er wordt een set mappen gemaakt in de huidige map:

    The starter template structure.

Notitie

Mogelijk hebt u gezien dat de opdracht ook een projectsjabloon met de azd init naam Minimal bevat, die de eenvoudigste sjabloonstructuur bevat. De Starter - Bicep-sjabloon die u hebt geselecteerd, bevat echter extra scaffolding-code die erg nuttig is maar nog steeds technologieneutraal is, dus het is vaak een uitstekende keuze om aan de slag te gaan.

De gegenereerde mappen bevatten alle essentiële bouwstenen van een azd sjabloon:

  • .azdo - Een map met de startersconfiguratiebestanden .yml voor CI/CD met Azure Pipelines.
  • .azure : een map met essentiële instellingen voor de Azure-omgeving van de sjabloon, zoals de naam van de omgeving.
  • .devcontainer : een map met configuratiebestanden die worden gebruikt om de sjabloon uit te voeren in een ontwikkelcontaineromgeving.
  • .github : een map met een startersconfiguratiesjabloon .yml voor het instellen van een CI/CD-pijplijn via GitHub Actions.
  • infra - Een map met starter Bicep-bestanden voor de infrastructuur van de sjabloon als code. Als u de Terraform Starter-sjabloon hebt geselecteerd, bevat deze map in plaats daarvan Terraform-bestanden.
  • azure.yaml : een bestand dat beschrijft hoe de onderdelen van uw toepassing worden toegewezen aan services in Azure.

Deze starterssjabloon bevat het grootste deel van wat u nodig hebt om uw eigen azd sjabloon te maken. In de volgende verschillende eenheden leert u hoe u deze bestaande bestanden bijwerkt en nieuwe assets toevoegt om een volledige sjabloon te maken.