Hoe de Azure Developer CLI werkt

Voltooid

De Azure Developer CLI (azd) is gebouwd rond ontwikkelaarsvriendelijke opdrachten en basistoepassingssjablonen. azd biedt een set opdrachten waarmee u uw toepassing in Azure kunt onboarden en beheren met behulp van gestandaardiseerde projectsjablonen. Deze sjablonen bevatten alle benodigde broncode en configuratieassets voor het inrichten en implementeren van uw app in Azure. U kunt azd gaan gebruiken door een van de bestaande en uitbreidbare voorbeeldsjablonen te gebruiken of door uw eigen sjablonen te bouwen.

Opdrachten voor azd verkennen

De Azure Developer CLI bevat een bewerkbare set opdrachten die zijn toegewezen aan algemene ontwikkelingswerkstroomfasen, zoals het inrichten en implementeren van resources. Sommige azd opdrachten, zoals azd up ook meerdere fasen tegelijk verwerken om deze taken verder te stroomlijnen.

Een typische azd werkstroom met behulp van een bestaande sjabloon bevat bijvoorbeeld de volgende stappen:

1. Voer de opdracht azd init uit met de parameter --template om een bestaande sjabloon te klonen en stel een omgevingsnaam in wanneer hierom wordt gevraagd.

   azd init --template todo-nodejs-mongo
   

2. Voer de opdracht azd auth login uit om u aan te melden bij uw Azure-abonnement.

   azd auth login
   

3. Voer de opdracht azd up uit om de sjabloonbronnen in te richten en te implementeren in Azure.

   azd up
   

4. Zodra uw omgeving is ingesteld in Azure, kunt u de toepassingsfuncties of Azure-resourcesjablonen lokaal wijzigen en vervolgens azd up opnieuw uitvoeren om uw wijzigingen in te richten.

Andere azd opdrachten zijn beschikbaar om andere taken uit te voeren en deze werkstroom uit te breiden. azd is ontworpen voor een minimaal aantal opdrachten met enkele parameters voor gebruiksgemak. Enkele van de meest voorkomende azd opdrachten zijn:

• azd init - Initialiseer een nieuwe toepassing.
• azd up - Azure-resources inrichten en uw project met één opdracht implementeren.
• azd provision - De Azure-resources inrichten voor een toepassing.
• azd deploy - Implementeer de toepassingscode in Azure.
• azd pipeline - (bèta) Uw implementatiepijplijnen beheren en configureren.
• azd auth - Verifiëren met Azure.
• azd-configuratie - Azd-configuraties beheren (bijvoorbeeld standaard Azure-abonnement, locatie).
• azd down - Azure-resources voor een toepassing verwijderen.

Sjablonen voor azd verkennen

De Azure Developer CLI-opdrachten zijn ontworpen om te werken met gestandaardiseerde projectsjablonen. Elke sjabloon is een codeopslagplaats die voldoet aan specifieke bestands- en mapconventies. De sjablonen bevatten de assets die azd nodig hebben om Azure-resources in te richten en eventueel de broncode van de toepassing te implementeren. Sommige sjablonen bevatten mogelijk geen toepassingsbroncode onder de veronderstelling dat u uw eigen broncode toevoegt. Wanneer u een opdracht uitvoert, zoals azd up, gebruikt het hulpprogramma de projectsjabloonassets om verschillende werkstroomstappen uit te voeren, zoals het inrichten of implementeren van resources in Azure.

Er zijn twee hoofdmethoden voor het werken met azd sjablonen:

• Een bestaande azd-sjabloon uitbreiden: er bestaat al een grote bibliotheek met azd-sjablonen voor algemene lokale toepassingsstacks, scenario's en architecturen. U kunt door veel van de sjablonen bladeren op de awesome-azd-sjabloonbibliotheek site. Als u een sjabloon vindt die is toegewezen aan uw lokale toepassingsstack of de gewenste architectuur, kunt u deze als uitgangspunt gebruiken. Vervang vervolgens de broncodemap en wijzig de configuratie- of infrastructuurbestanden om aan uw behoeften te voldoen.

• Uw eigen app omzetten in een azd sjabloon - U kunt ook een bestaande app omzetten in een azd template sjabloon door de Uw project compatibel maken met azd handleiding te volgen. Het maken van uw eigen sjabloon is in eerste instantie vaak meer werk, maar biedt de meeste controle en produceert een herbruikbare oplossing voor toekomstig ontwikkelwerk aan de app. De belangrijkste stappen voor het maken van uw eigen sjabloon zijn als volgt:

  • Initialiseer de projectsjabloon met azd init.

  • Maak de infrastructuur als codebestanden met Bicep of Terraform.

  • Werk het azure.yaml-bestand bij om de app-services te koppelen aan de Azure-resources.

  • Voorziening & uitrollen met azd up.

    

Ongeacht welke benadering u kiest, is de resulterende sjabloonstructuur hetzelfde. Alle azd-sjablonen bevatten de volgende assets:

• infra map bevat alle infrastructuur als codebestanden voor Bicep of Terraform voor de azd sjabloon. Met infrastructuur als code kunt u infrastructuurresources en configuraties definiëren in declaratieve definitiebestanden die op betrouwbare wijze dezelfde omgevingen genereren wanneer ze worden geïmplementeerd. Terraform werkt op meerdere cloudplatforms, terwijl Bicep specifiek is voor Azure. azd voert deze bestanden uit om de Azure-resources te maken die nodig zijn om uw app te hosten. Meer informatie over infrastructuur als code vindt u in de Wat is infrastructuur als code? trainingsmodule.

• azure.yaml bestand: een configuratiebestand dat een of meer services in uw project definieert en deze toe wijst aan Azure-resources voor implementatie. U kunt bijvoorbeeld een API-service en een webfront-endservice definiëren, elk met kenmerken die deze toewijzen aan verschillende Azure-resources voor implementatie.

• .azure map: bevat essentiële Azure-configuraties en omgevingsvariabelen, zoals de locatie voor het implementeren van resources of andere abonnementsgegevens.

• src folder: bevat alle broncode van de implementeerbare app. Sommige azd-sjablonen bieden alleen infrastructuurassets en laten de src map leeg zodat u uw eigen toepassingscode kunt toevoegen.

  

De meeste azd sjablonen bevatten desgewenst ook een of meer van de volgende mappen:

• .devcontainer map: hiermee kunt u een Dev Container-omgeving instellen voor uw toepassing. Een algemene benadering van de ontwikkelomgeving die niet specifiek is voor azd.
• .github directory - bevat de CI/CD-werkstroombestanden voor GitHub Actions, de standaard CI/CD-provider voor azd.
• .azdo map: als u Besluit Azure Pipelines voor CI/CD te gebruiken, definieert u de configuratiebestanden van de werkstroom in deze map.