Dela via

Snabbstart: Skapa och distribuera en Python-webbapp från GitHub Codespaces till Azure med hjälp av en CLI-mall för Azure Developer

Den här snabbstarten vägleder dig genom det enklaste och snabbaste sättet att skapa och distribuera en Python-webb- och databaslösning till Azure. Genom att följa anvisningarna i den här snabbstarten gör du följande:

  • Välj en AZURE Developer CLI-mall (azd) baserat på Python-webbramverket, Azure-databasplattformen och azure-webbvärdplattformen som du vill bygga vidare på.
  • Skapa ett nytt GitHub Codespace som innehåller kod som genererats från den azd mall som du har valt.
  • Använd GitHub Codespaces och Visual Studio Code-bash-terminalen online. Med terminalen kan du använda Azure Developer CLI-kommandon för att köra en azd mall för att skapa en exempelwebbapp och databas, skapa och konfigurera nödvändiga Azure-resurser och sedan distribuera exempelwebbappen till Azure.
  • Redigera webbappen i ett GitHub Codespace och använd ett azd kommando för att distribuera om.
  • Använd ett azd kommando för att rensa Azure-resurser.
  • Stäng och öppna GitHub Codespace igen.
  • Publicera din nya kod till en GitHub-lagringsplats.

Det bör ta mindre än 25 minuter att slutföra den här självstudien. När du är klar kan du börja ändra det nya projektet med din anpassade kod.

Om du vill veta mer om dessa azd mallar för utveckling av Python-webbappar:

Förutsättningar

Viktigt!

Både GitHub Codespaces och Azure är betalda prenumerationsbaserade tjänster. Efter några kostnadsfria tilldelningar kan du debiteras för att använda dessa tjänster. Att följa den här snabbstartsguiden kan påverka dessa resurser eller fakturering. När det azd är möjligt skapades mallarna med den billigaste nivån med alternativ, men vissa kanske inte är kostnadsfria. Använd Priskalkylatorn för Azure för att bättre förstå kostnaderna. För mer information, se GitHub Codespaces prissättning.

Välj en mall och skapa ett kodområde

Välj en azd mall baserat på Python-webbramverket, Azure-webbvärdplattformen och den Azure-databasplattform som du vill bygga vidare på.

  1. I följande lista över mallar väljer du en som använder de tekniker som du vill använda i ditt nya webbprogram.

    Mall Webbramverk Databas Värdplattform Nytt kodområde
    azure-django-postgres-flexible-aca Django Django Flexibel PostgreSQL-server Azure Container-applikationer Nytt kodområde
    azure-django-postgres-flexible-appservice Django Django Flexibel PostgreSQL-server Служб Nytt kodområde
    azure-django-cosmos-postgres-aca Django Django Cosmos DB (PostgreSQL Adapter) Azure Container-applikationer Nytt kodområde
    azure-django-cosmos-postgres-appservice Django Django Cosmos DB (PostgreSQL Adapter) Служб Nytt kodområde
    Addon för Azure, Django och Postgres - ACA Django Django PostgreSQL-tillägg för Azure Container Apps Azure Container-applikationer Nytt kodområde

  1. För att underlätta för dig innehåller den sista kolumnen i varje tabell en länk som skapar ett nytt codespace och initierar mallen azd i ditt GitHub-konto. Högerklicka och välj "Öppna på ny flik" på länken "Nytt kodområde" bredvid det mallnamn som du valde för att starta installationsprocessen.

    Under den här processen kan du uppmanas att logga in på ditt GitHub-konto och du uppmanas att bekräfta att du vill skapa kodområdet. Välj knappen "Skapa kodområde" för att se sidan "Konfigurera ditt kodområde".

  2. Efter några minuter läses en webbaserad version av Visual Studio Code in på en ny flik i webbläsaren, med Python-webbmallen laddad som en arbetsyta i Utforskaren.

Autentisera till Azure och distribuera azd-mallen

Nu när du har ett GitHub Codespace som innehåller den nyligen genererade koden använder azd du verktyget inifrån Codespace för att publicera koden till Azure.

  1. I den webbaserade Visual Studio Code ska terminalen vara öppen som standard. Om den inte är det använder du tilde-nyckeln ~ för att öppna terminalen. Dessutom bör terminalen som standard vara en bash-terminal. Om det inte är det, ändra till bash i det övre högra hörnet av terminalfönstret.

  2. I bash-terminalen anger du följande kommando:

    azd auth login

    azd auth login börjar autentisera ditt Codespace till ditt Azure-konto.

    Start by copying the next code: XXXXXXXXX
Then press enter and continue to log in from your browser...

Waiting for you to complete authentication in the browser...

  3. Följ anvisningarna, bland annat:

    • Kopiera en genererad kod
    • Markera retur för att öppna en ny webbläsarflik och klistra in koden i textrutan
    • Välja ditt Azure-konto från en lista
    • Bekräftar att du försöker logga in på Microsoft Azure CLI

  4. När det lyckas visas följande meddelande tillbaka på fliken Codespaces i terminalen:

    Device code authentication completed.
Logged in to Azure.

  5. Distribuera ditt nya program till Azure genom att ange följande kommando:

    azd up

    Under den här processen uppmanas du att:

    • Ange ett nytt miljönamn
    • Välj en Azure-prenumeration som du vill använda [Använd pilar för att flytta, skriv för att filtrera]
    • Välj en Azure-plats att använda: [Använd pilar för att flytta, skriv för att filtrera]

    När du har besvarat dessa frågor indikerar utdata från azd att distributionen pågår.

    Viktigt!

    När azd up har slutförts framgångsrikt kommer exempelwebbappen att vara tillgänglig på den offentliga internet och din Azure-prenumeration börjar påföra avgifter för alla resurser som skapas. Skaparna av azd mallarna valde avsiktligt billiga nivåer men inte nödvändigtvis kostnadsfria nivåer eftersom kostnadsfria nivåer ofta har begränsad tillgänglighet. När du har arbetat klart med exempelwebbappen använder azd down du för att ta bort alla tjänster som har skapats av azd up.

    Följ anvisningarna när du uppmanas att välja Azure-prenumeration som ska användas för betalning och välj sedan en Azure-plats att använda. Välj en region som ligger nära dig geografiskt.

    Det kan ta flera minuter att azd up köra eftersom det etablerar och distribuerar flera Azure-tjänster. När förloppet visas kan du hålla utkik efter fel. Om du ser fel kan du läsa avsnittet Felsökning längst ned i det här dokumentet.

  6. När azd up lyckas visas liknande utdata:

    (✓) Done: Deploying service web
- Endpoint: https://xxxxx-xxxxxxxxxxxxx-ca.example-xxxxxxxx.westus.azurecontainerapps.io/

SUCCESS: Your application was provisioned and deployed to Azure in 11 minutes 44 seconds.
You can view the resources created under the resource group xxxxx-rg in Azure Portal:
https://portal.azure.com/#@/resource/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/xxxxx-rg/overview

    Om du ser en standardskärm eller felskärm kan appen startas. Vänta 5–10 minuter för att se om problemet löser sig innan du felsöker.

    Ctrl + klicka på den första URL:en efter ordet - Endpoint: för att se exempelwebbappprojektet som körs live i Azure.

  7. Ctrl + klicka på den andra URL:en från föregående steg för att visa de etablerade resurserna i Azure-portalen.

Redigera och distribuera om

Nästa steg är att göra en liten ändring i webbappen och sedan distribuera om.

  1. Gå tillbaka till webbläsarfliken som innehåller Visual Studio Code och använd Utforskarvyn i Visual Studio Code för att navigera till mappen src/templates och öppna filenindex.html . Leta upp följande kodrad:

    <h1 id="page-title">Welcome to ReleCloud</h1>

    Ändra texten i H1:

    <h1 id="page-title">Welcome to ReleCloud - UPDATED</h1>

    Koden sparas när du skriver.

  2. Om du vill distribuera om appen med din ändring kör du följande kommando i terminalen:

    azd deploy

  3. När kommandot har slutförts uppdaterar du webbläsarfliken med ReleCloud-webbplatsen för att se uppdateringen. Beroende på vilken webbvärdplattform som används kan det ta flera minuter innan ändringarna visas.

    Nu är du redo att redigera och ta bort filer i mallen. Mer information finns i Vad kan jag redigera eller ta bort i mallen?

Rensa resurser

Rensa resurserna som skapas av mallen genom att köra kommandot azd ned.

azd down

Kommandot azd down tar bort Azure-resurserna och GitHub Actions-arbetsflödet. När du uppmanas till det godkänner du att alla resurser som är associerade med resursgruppen tas bort.

Valfritt: Hitta ditt kodområde

Det här avsnittet visar hur koden (tillfälligt) körs och bevaras kortsiktigt i ett Codespace. Om du planerar att fortsätta arbeta med koden bör du publicera koden till en ny lagringsplats.

  1. Stäng alla flikar som är relaterade till den här snabbstartsartikeln eller stäng webbläsaren helt.

  2. Öppna webbläsaren och en ny flik och gå till: https://github.com/codespaces

  3. Längst ned ser du en lista över de senaste Kodytorna. Leta efter den du skapade i ett avsnitt med titeln "Owned by Azure-Samples".

  4. Välj ellipsen till höger om kodområdet för att visa en snabbmeny. Härifrån kan du byta namn på kodområdet, publicera till en ny lagringsplats, ändra datortyp, stoppa kodområdet med mera.

Valfritt: Publicera en GitHub-lagringsplats från Codespaces

Nu har du ett Codespace, som är en container som hanteras av GitHub och som kör din Visual Studio Code-utvecklingsmiljö med din nya kod som genereras från en azd mall. Koden lagras dock inte på en GitHub-lagringsplats. Om du planerar att fortsätta arbeta med koden bör du prioritera det.

  1. På snabbmenyn för kodområdet väljer du "Publicera till en ny lagringsplats".
  2. I dialogrutan "Publicera till en ny lagringsplats" byter du namn på din nya lagringsplats och väljer om du vill att den ska vara en offentlig eller privat lagringsplats. Välj "Skapa lagringsplats".
  3. Efter en liten stund skapas lagringsplatsen och koden som du genererade tidigare i den här snabbstarten skickas till den nya lagringsplatsen. Välj knappen "Se lagringsplats" för att navigera till den nya lagringsplatsen.
  4. Om du vill öppna och fortsätta redigera kod väljer du den gröna listrutan "<> Kod", växlar till fliken Codespaces och väljer namnet på det Kodområde som du arbetade med tidigare. Du bör nu returneras till din Codespace Visual Studio Code-utvecklingsmiljö.
  5. Använd fönstret Källkontroll för att skapa nya grenar och stagera och checka in nya ändringar i koden.

Felsökning

Om du ser fel under azd upkan du prova följande:

  • Kör azd down för att ta bort alla resurser som kan ha skapats. Du kan också ta bort resursgruppen som skapades i Azure-portalen.
  • Gå till sidan Codespaces för ditt GitHub-konto, leta reda på kodområdet som skapades under den här snabbstarten, välj ellipsen till höger och välj "Ta bort" på snabbmenyn.
  • Sök efter Key Vaults i Azure-portalen. Välj hantera borttagna valv, välj din prenumeration, välj alla nyckelvalv som innehåller namnet azdtest eller vad du har döpt till din miljö och välj Rensa.
  • Försök med stegen i den här snabbstarten igen. Den här gången när du uppmanas till det väljer du ett enklare namn för din miljö. Prova ett kort namn, små bokstäver, inga siffror, inga stora bokstäver, inga specialtecken.
  • När du försöker utföra snabbstartsstegen igen väljer du en annan plats.

Mer information om möjliga problem och lösningar finns i Vanliga frågor och svar.

Relaterat innehåll