In deze quickstart leert u hoe u app-resources in Azure kunt inrichten en implementeren met behulp van een azd () en slechts een paar azd opdrachten.
azd sjablonen zijn standaardcodeopslagplaatsen die de broncode van uw toepassing bevatten, evenals azd configuratie- en infrastructuurbestanden voor het inrichten van Azure-resources. Zie azd? voor meer informatie over sjablonen en hoe ze uw Azure-inrichtings- en implementatieproces kunnen versnellen.
De sjabloon selecteren en implementeren
Voor de volgende stappen gebruikt u de volgende sjabloon om een app in Azure in te richten en te implementeren:
U kunt ook een sjabloon selecteren die overeenkomt met uw voorkeuren op de site geweldige AZD-sjabloongalerie . Ongeacht welke sjabloon u gebruikt, eindigt u met de sjablooncode in uw ontwikkelomgeving en kunt u opdrachten uitvoeren om de app in Azure te bouwen, opnieuw te implementeren en te bewaken.
Selecteer uw voorkeursomgeving om door te gaan:
Een lokale ontwikkelomgeving is een uitstekende keuze voor traditionele ontwikkelwerkstromen. U kloont de sjabloonopslagplaats op uw apparaat en voert opdrachten uit op een lokale installatie van azd.
Vereisten
Het project initialiseren
Maak in Bestandenverkenner of een terminal een nieuwe lege map en wijzig deze in.
Voer de azd init opdracht uit en geef de sjabloon op die u wilt gebruiken als parameter:
azd init --template todo-nodejs-mongo
azd init --template todo-python-mongo
azd init --template todo-csharp-cosmos-sql
azd init --template todo-java-mongo-aca
Voer een omgevingsnaam in wanneer hierom wordt gevraagd, bijvoorbeeld azdquickstart, waarmee een naamgevingsvoorvoegsel wordt ingesteld voor de resourcegroep die wordt gemaakt om de Azure-resources op te slaan.
Wat is een omgevingsnaam?azd
Nadat u de omgeving hebt opgegeven, azd kloont u het sjabloonproject naar uw computer en initialiseert u het project.
De app-resources inrichten en implementeren
Voer de azd auth login opdracht uit en azd start een browser om het aanmeldingsproces te voltooien.
azd auth login
Voer de azd up opdracht uit:
azd up
Zodra u bent aangemeld bij Azure, wordt u gevraagd om de volgende informatie:
| Parameter |
Description |
Azure Location |
De Azure-locatie waar uw resources worden geïmplementeerd. |
Azure Subscription |
Het Azure-abonnement waar uw resources worden geïmplementeerd. |
Selecteer de gewenste waarden en druk op Enter. De azd up opdracht verwerkt de volgende taken voor u met behulp van de sjabloonconfiguratie- en infrastructuurbestanden:
- Hiermee maakt en configureert u alle benodigde Azure-resources (
azd provision), waaronder:
- Toegangsbeleid en rollen voor uw account
- Service-naar-service-communicatie met beheerde identiteiten
- Pakketten en implementeert de code (
azd deploy)
Wanneer de azd up opdracht is voltooid, worden in de CLI twee koppelingen weergegeven om resources weer te geven die zijn gemaakt:
- Taken-API-app
- Front-end voor toDo-web-app
Notitie
U kunt zo vaak aanroepen azd up als u wilt dat updates voor uw toepassing worden ingericht en geïmplementeerd.
De implementatie kan mislukken omdat een resource niet kan worden geïmplementeerd in de geselecteerde regio. Omdat dit een snelle start is, is het veilig om de .azure map te verwijderen en het opnieuw te proberen azd up . Wanneer u hier om wordt gevraagd, selecteert u een andere regio. In een geavanceerder scenario kunt u selectief bestanden in de .azure map bewerken om de regio te wijzigen.
De Azure Developer CLI biedt een Visual Studio Code-extensie om het werken met azd functies te stroomlijnen. U kunt bijvoorbeeld de interface voor het opdrachtenpalet gebruiken om opdrachten uit te voeren azd . U moet de Azure Developer CLI-extensie voor Visual Studio Code installeren om de stappen vooruit te voltooien.
De Azure Developer CLI-extensie installeren
Open Visual Studio Code.
Selecteer Extensies in het menu Beeld.
Voer in het zoekveld in Azure Developer CLI.
Selecteer Installeren en wacht tot het installatieproces is voltooid.
Een nieuwe app initialiseren
Open een lege map in Visual Studio Code.
Selecteer in het menu Beeldopdrachtpalet....
Zoek de Azure Developer CLI (azd): Initialize app (init) opdracht en druk op Enter. Met azd up de opdracht wordt azd opdracht gegeven om de app-resources in te richten en te implementeren.
Kies de werkstroom Een sjabloon selecteren .
Zoek naar de React Web App met Node.js API en MongoDB in de Azure-sjabloon en druk op Enter om deze te selecteren.
Visual Studio Code kloont de azd sjabloon omlaag. De sjabloon bevat infrastructuur als codebestanden in de infra map en een voorbeeld-app in de src map. Met de infrastructuur als codebestanden worden de vereiste resources ingericht in Azure die door de app zijn vereist wanneer deze wordt geïmplementeerd.
Zoek de React Web App met Python-API en MongoDB op de Azure-sjabloon en druk op Enter om deze te selecteren.
Visual Studio Code kloont de azd sjabloon omlaag. De sjabloon bevat infrastructuur als codebestanden in de infra map en een voorbeeld-app in de src map. Met de infrastructuur als code-bestanden worden de benodigde resources in Azure ingericht die door de app nodig zijn bij implementatie.
Zoek naar de React Web App met C#-API en MongoDB op een Azure-sjabloon en druk op Enter om deze te selecteren.
Visual Studio Code kloont de azd sjabloon omlaag. De sjabloon bevat infrastructuur als codebestanden in de infra map en een voorbeeld-app in de src map. Met de infrastructure as code-bestanden worden de benodigde resources op Azure voorzien, die de app nodig heeft bij implementatie.
Zoek naar de In containers geplaatste React Web App met Java-API en MongoDB op een Azure-sjabloon en druk op Enter om deze te selecteren.awesome-azd.
Visual Studio Code kloont de azd sjabloon omlaag. De sjabloon bevat infrastructuur als codebestanden in de infra map en een voorbeeld-app in de src map. Infrastructuur-als-code-bestanden richten de benodigde resources in op Azure, die door de app benodigd zijn wanneer ze wordt geïmplementeerd.
Nadat de sjabloon is gekloond, opent Visual Studio Code een terminal om u om een omgevingsnaam te vragen. Voer een korte naam in van uw keuze, zoals azdvscode en druk op Enter.
Enter a new environment name: [? for help] azdvscode
De omgevingsnaam is van invloed op de naamgeving van resources die zijn ingericht in Azure en maakt een map in de .azure sjabloonmap om bepaalde omgevingsinstellingen op te slaan.
De app-resources inrichten en implementeren
Open het opdrachtpalet en zoek de Azure Developer CLI (azd): Package, Provision and Deploy(up) opdracht en druk op Enter. Met azd up de opdracht wordt azd opdracht gegeven om de app-resources in te richten en te implementeren.
Visual Studio Code opent een terminalvenster om de voortgang van het inrichtings- en implementatieproces weer te geven.
azd gebruikt de abonnements- en locatie-instellingen die u tijdens het proces hebt geselecteerd bij het init implementeren van resources.
Notitie
Het inrichtings- en implementatieproces kan enkele minuten duren.
Wanneer het implementatieproces is voltooid, selecteert u de koppeling in het uitvoervenster dat door azd is opgegeven om uw site in de browser te openen.
Codespaces zijn een uitstekende optie voor ontwikkelaars die liever in containeromgevingen werken en geen hulpprogramma's of afhankelijkheden lokaal installeren.
Uw Codespace instellen
- Klik boven de lijst met bestanden op Deze sjabloon openen>in een Codespace.
Met Codespaces worden alle vereisten voor u geïnstalleerd, inclusief de azd Visual Studio Code-extensie.
De sjabloon uitvoeren
Zodra uw Codespace is gemaakt, klikt u met de rechtermuisknop op azure.yaml in de hoofdmap. Selecteer in de opties de optie (resources inrichten en implementeer code in Azure).
Wanneer u de azd up opdracht uitvoert, wordt u gevraagd om de volgende informatie op te geven en u aan te melden met een webbrowser en een verificatiecode:
| Parameter |
Description |
Environment Name |
Voorvoegsel voor de resourcegroep die wordt gemaakt om alle Azure-resources te bewaren. Wat is een omgevingsnaam?azd U kunt altijd een nieuwe omgeving maken met azd env new. |
Azure Location |
De Azure-locatie waar uw resources worden geïmplementeerd. |
Azure Subscription |
Het Azure-abonnement waar uw resources worden geïmplementeerd. |
Dit proces kan enige tijd duren, omdat de azd up opdracht de volgende taken afhandelt:
- Hiermee maakt en configureert u alle benodigde Azure-resources (
azd provision).
- Hiermee configureert u toegangsbeleid en -rollen voor uw account.
- Implementeert service-naar-service-communicatie met beheerde identiteiten.
- Pakketten en implementeert de code (
azd deploy).
Nadat u de benodigde parameters hebt opgegeven en de opdracht is voltooid, worden in de azd up CodeSpaces-terminal twee Koppelingen van Azure Portal weergegeven om resources weer te geven die zijn gemaakt:
- Taken-API-app
- Front-end voor toDo-web-app
Wat is er gebeurd?
Na een geslaagde voltooiing van de azd up opdracht:
- De
README.md van de sjabloon wordt verwezen, zijn ingericht voor het Azure-abonnement dat u hebt opgegeven nadat u het hebt uitgevoerdazd up. U kunt deze Azure-resources nu bekijken via Azure Portal.
- De app is gebouwd en geïmplementeerd in Azure. Met behulp van de URL-uitvoer van de web-app van de
azd up opdracht kunt u bladeren naar de volledig functionele app.
Een DevContainer is een Docker-installatiekopieën met alle vereisten die u nodig hebt om met de azd sjabloon op uw lokale computer te werken. Ze zijn een uitstekende keuze voor ontwikkelaars die de voorkeur geven aan containeromgevingen die nog steeds worden uitgevoerd op een lokaal apparaat in plaats van een cloudservice zoals GitHub Codespaces.
Vereisten
Het project initialiseren
Open een terminal, maak een nieuwe lege map en wijzig deze.
Voer de volgende opdracht uit om het project te initialiseren:
azd init --template todo-nodejs-mongo
azd init --template todo-python-mongo
azd init --template todo-csharp-cosmos-sql
azd init --template todo-java-mongo-aca
Wanneer u de azd init opdracht uitvoert, wordt u gevraagd de volgende informatie op te geven:
| Parameter |
Description |
Environment Name |
Voorvoegsel voor de resourcegroep die wordt gemaakt om alle Azure-resources te bewaren. Wat is een omgevingsnaam?azd U kunt altijd een nieuwe omgeving maken met azd env new. |
De DevContainer openen
- Open het project in VS Code.
- Druk op F1 en kies:
Remote-Containers: Rebuild and Reopen in Container
Opdracht Uitvoeren up
Voer de volgende opdracht uit:
azd up
Wanneer u de azd up opdracht uitvoert, wordt u gevraagd de volgende informatie op te geven:
| Parameter |
Description |
Azure Location |
De Azure-locatie waar uw resources worden geïmplementeerd. |
Azure Subscription |
Het Azure-abonnement waar uw resources worden geïmplementeerd. |
Het azd up kan enige tijd duren voordat de opdracht wordt uitgevoerd wanneer deze de volgende stappen uitvoert:
- Hiermee maakt en configureert u alle benodigde Azure-resources (
azd provision), waaronder:
- Toegangsbeleid en rollen voor uw account
- Service-naar-service-communicatie met beheerde identiteiten
- Pakketten en implementeert de code (
azd deploy)
Nadat u de benodigde parameters hebt opgegeven en de azd up opdracht is voltooid, worden in de CLI twee Koppelingen naar Azure Portal weergegeven om de gemaakte resources weer te geven:
- Taken-API-app
- Front-end voor toDo-web-app
Notitie
U kunt zo vaak als u wilt uitvoeren azd up om uw toepassing in te richten en te implementeren in dezelfde regio en met dezelfde configuratiewaarden die u tijdens de eerste uitvoering hebt opgegeven.
Resources opschonen
Wanneer u de resources die in dit artikel zijn gemaakt niet meer nodig hebt, voert u de volgende opdracht uit om de app uit te schakelen:
azd down
Als u opnieuw wilt implementeren naar een andere regio, verwijdert u de .azure map voordat u deze opnieuw uitvoert azd up . In een geavanceerder scenario kunt u selectief bestanden in de .azure map bewerken om de regio te wijzigen.
Hulp vragen
Ga naar de pagina voor probleemoplossing en ondersteuning voor informatie over het indienen van een bug, hulp vragen of een nieuwe functie voorstellen voor de Azure Developer CLI.
Volgende stappen