Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
AZURE Developer CLI (azd) är ett kommandoradsverktyg med öppen källkod som ersätter manuell installation och konfiguration med konsekventa kommandon för att skapa och distribuera appar på Azure.
I den här snabbstarten initierar du en exempelmall och distribuerar den till Azure. Du får en app som körs på Azure och ett återanvändbart lokalt projekt som du kan distribuera om, anpassa eller ta bort när du är klar.
Förutsättningar
Kontrollera att du har följande förutsättningar innan du börjar:
- Ett Azure konto med en aktiv prenumeration. Skapa ett konto kostnadsfritt.
- Ha Azure Developer CLI installerat.
- För .NET-exemplet krävs .NET 10 SDK.
Kommentar
Båda exemplen bygger containeravbildningar på distans i Azure. Python-exemplet kräver inte någon lokal Python-installation för driftsättning. Det .NET exemplet kräver fortfarande en lokal .NET SDK eftersom dess postprovision hook kör dotnet user-secrets set.
Förstå azd-mallar
En azd mall är ett källkodsrepository som innehåller allt som azd behöver för att fungera med en app. Du kan skapa en egen mall för en ny eller befintlig app, eller börja från en befintlig mall och anpassa den. I den här snabbstarten använder du en exempelmall så att du kan fokusera på kärnarbetsflödet azd .
Följande struktur visar en förenklad vy på den översta nivån av en typisk mall:
|-- src/ # Application source code
|-- infra/ # Azure resources defined as infrastructure as code
|-- azure.yaml # azd project configuration
`-- .azure/ # Local environment settings
Fullständig uppdelning av dessa filer finns i Utforska och redigera mallfiler.
Initiera mallen
I den överordnade katalogen där du vill lagra projektet väljer du en exempellagringsplats och kör azd init:
Det här alternativet använder exempellagringsplatsen hello-azd-python .
azd init --template hello-azd-python
azd stöder många språk, ramverk och containrar. Mer information finns i Språk och miljöer som stöds.
När du uppmanas till det anger du ett kort miljönamn, till exempel dev. När initieringen är klar öppnar du den nya projektkatalogen i terminalen innan du fortsätter.
Kommandot azd init:
- Laddar ned den valda mallen till den nya projektkatalogen.
- Initierar den nya katalogen som ett
azdprojekt. - Skapar en miljö som lagrar distributionsinställningar, till exempel din Azure prenumeration och plats, under
.azurekatalogen.
Kommandot skapar eller distribuerar inte några Azure resurser.
Logga in på Azure
Kör följande kommando och logga sedan in via webbläsaren:
azd auth login
Etablera och distribuera appresurserna
Kör följande kommando:
azd up
När du uppmanas till det väljer du den Azure-prenumeration och plats som ska användas. Den första distributionen kan ta flera minuter eftersom azd up kör det fullständiga distributionsarbetsflödet:
- Etablera: Skapar de Azure resurser som mallens infrastruktur-som-kod-filer definierar.
- Paket: Bygger och paketerar appen för distribution. Exemplet använder ett fjärrcontainerbygge, så bygget körs i Azure.
- Distribuera: Distribuerar den paketerade appen till den etablerade värdresursen.
Mallen definierar stödresurser, till exempel hanterade identiteter, rolltilldelningar och programinställningar, i Bicep filer under infra katalogen och azure.yaml projektkonfigurationen och azd distribuerar dem tillsammans med appen. Mer information om dessa filer finns i Utforska och redigera mallfiler.
Du kan köra azd up igen när du har ändrat appen eller infrastrukturen.
azd uppdaterar den befintliga miljön i stället för att skapa en separat driftsättning.
Utforska den driftsatta appen
När azd up den är klar skriver den ut länkar till de etablerade resurserna och den app som körs i kommandoutdata.
Välj länken till Azure-portalsresursgruppen i utdata för att visa de resurser som
azdhar etablerat.
Välj länken för appens endpoint i utdata för att öppna appen som körs i en webbläsare.
Gör en ändring och distribuera om
Du kan också göra en liten ändring i exempelappen och sedan distribuera om bara appkoden med azd deploy.
- Öppna
src/app/templates/home.html. - Leta upp
<h1>Hello, customized template!</h1>rubriken. - Ersätt rubriktexten med
<h1>Hello from your azd template!</h1>och spara sedan filen.
Den här ändringen påverkar endast appkällan, så du behöver inte provisionera infrastrukturen på nytt. Distribuera om den uppdaterade koden:
azd deploy
Kommandot azd deploy paketerar och distribuerar endast appkoden, medan azd up kör hela arbetsflödet för etablering, paketering och distribution. När kommandot är klart öppnar du appslutpunkten från kommandoutdata. Startsidan visar den uppdaterade rubriken.
Rensa resurser
När du är klar kör du följande kommando för att ta bort Azure resurser och undvika löpande avgifter:
azd down
Bekräfta borttagningen när du uppmanas att göra det. Det här kommandot tar bort de resurser som azd har etablerats för den aktuella miljön men behåller de lokala projektfilerna.
Nästa steg
Begär hjälp
Information om hur du skickar in en bugg, begär hjälp eller föreslår en ny funktion för Azure Developer CLI finns på sidan troubleshooting and support.