overzicht van Azure Developer CLI (azd)-sjabloonontwikkeling

Azure Developer CLI-sjablonenazd verpakken de configuratie, infrastructuur en optionele toepassingscode die is vereist voor het inrichten en implementeren van een oplossing op Azure. U kunt een sjabloon gebruiken voor een toepassing, een alleen-infrastructuurproject of een herbruikbaar uitgangspunt voor toekomstige projecten.

Note

Lees voordat u begint Azure Cli-sjablonen voor ontwikkelaars voor een volledige beschrijving van sjabloonstructuur, vereiste en optionele assets, service-naar-resourcekoppelingen en hoe azd opdrachten elk bestand gebruiken.

Werkstroom voor sjabloonontwikkeling

De volgende werkstroom is van toepassing of u een sjabloon maakt of initialiseert die al bestaat:

Diagram van de ontwikkelwerkstroom voor Azure Developer CLI-sjablonen. Aan de linkerkant bevat een vak met de naam 'Kies een beginpunt' twee opties: 'Beginnen met een nieuwe sjabloon' en 'Beginnen met een bestaande sjabloon'. Beide opties leiden tot 'De sjabloonbestanden verkennen en bewerken'. Van daaruit leidt een optioneel pad omlaag naar "Sjabloon uitbreiden", en het hoofdpad loopt verder naar "azd up uitvoeren." De stap 'De template uitbreiden' komt ook uit op 'azd up uitvoeren'. Tot slot brengt het commando 'azd up' je uiteindelijk bij 'De sjabloon onderhouden of delen'.

• Kies een beginpunt:Begin met een nieuwe sjabloon met de GitHub Copilot-integratie, een andere AI-coderingsassistent of directe creatie. U kunt ook beginnen met een bestaande sjabloon uit Microsoft, uw organisatie of de ontwikkelaarscommunity.
• De bestanden verkennen en bewerken: Bekijk hoeazure.yaml, Bicep- of Terraform-bestanden, app-code en ondersteunende configuratie samenwerken. Zie Sjabloonbestanden verkennen en bewerken.
• Breid het volgende uit en ontwikkel deze naar behoefte: App- en infrastructuuronderdelen toevoegen, vervangen, verwijderen of opnieuw ontwerpen. Volg Een sjabloon uitbreiden voor een end-to-end-voorbeeld dat een Azure resource toevoegt en deze verbindt met een app.
• Inrichten en implementeren: Voer deze opdracht uit azd up om de infrastructuur in te richten en app-services te implementeren. Zie De werkstroom verkennen azd upvoor meer informatie.
• Onderhouden of delen: Ga door met het bewerken van de sjabloon naarmate uw project zich ontwikkelt. Als u van plan bent het te delen, test het dan eerst in een schone map en in een nieuwe azd-omgeving.

Note

In deze werkstroom kunt u zelf sjabloonbestanden maken, bewerken of vervangen, of met hulp van een AI-coderingsassistent. Het resultaat is dezelfde reeks bewerkbare azd standaardassets.

Sjabloonbouwstenen

Elke azd sjabloon ondersteunt een andere oplossing, maar de meeste sjablonen combineren dezelfde typen assets:

• Project configuratie: het azure.yaml bestand identificeert de project, implementeerbare services, bronmappen, hostingdoelen en optionele hooks of werkstromen.
• Infrastructuur als code: Bicep- of Terraform-bestanden definiëren de Azure resources, roltoewijzingen, netwerken en app-instellingen die de oplossing nodig heeft.
• Toepassingsbron: Een sjabloon kan een of meer implementeerbare apps bevatten of kan alleen infrastructuur bevatten.
• Omgevingsconfiguratie: Parameters geven omgevingsspecifieke waarden door aan implementaties en infrastructuuruitvoer worden waarden in de actieve azd omgeving.

Een sjabloon voor een app kan de volgende mapstructuur gebruiken:

.
├── azure.yaml                # Project configuration
├── infra/                    # Infrastructure as code
│   ├── main.bicep
│   ├── main.parameters.json
│   └── modules/
├── src/                      # Application source
│   ├── api/
│   └── web/
├── .github/                  # Pipeline workflows
│   └── workflows/
└── README.md

De exacte structuur varieert per project. Broncode van de app, infrastructuurmodules en pipelinebestanden zijn optioneel, en azure.yaml identificeert de paden die door azd worden gebruikt. Deze assets werken samen tijdens de levenscyclus van sjabloonontwikkeling.

Volgende stappen 

Beginnen met een nieuwe sjabloon

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.