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 för att Azure. Genom att följa anvisningarna i den här snabbstarten:

  • Välj mallen Azure Developer CLI (azd) baserat på Python webbramverk, Azure databasplattform och Azure webbvärdplattform som du vill bygga vidare på.
  • Skapa ett nytt GitHub Codespace som innehåller kod som genererats från mallen azd som du har valt.
  • Använd GitHub Codespaces och online-Visual Studio Code bash-terminalen. Med terminalen kan du använda Azure Cli-kommandon för utvecklare för att köra en azd-mall för att skapa en exempelwebbapp och databas och skapa och konfigurera nödvändiga Azure resurser och sedan distribuera exempelwebbappen till Azure.
  • Redigera webbappen i ett GitHub Codespace och använd kommandot azd för att distribuera om.
  • Använd kommandot azd 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.

Mer information om dessa azd mallar för Python webbappsutveckling finns i:

Förutsättningar

Viktigt!

Både GitHub Codespaces och Azure är betalda prenumerationsbaserade tjänster. Efter några kostnadsfria tilldelningar kan du behöva betala 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 använder mallarna den billigaste nivån med alternativ, men vissa kanske inte är kostnadsfria. Använd priskalkylatorn 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 webbramverk, Azure webbvärdplattform och 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 Flexibel PostgreSQL-server Azure Container Apps Ny kodmiljö
    azure-django-postgres-flexible-appservice Django Flexibel PostgreSQL-server Azure App Service Nytt kodutrymme
    azure-django-cosmos-postgres-aca Django Cosmos DB (PostgreSQL Adapter) Azure Container Apps Ny kodområde
    azure-django-cosmos-postgres-appservice Django Cosmos DB (PostgreSQL Adapter) Azure App Service Ny kodmiljö
    Addon för Azure, Django och Postgres - ACA Django Azure Container Apps PostgreSQL-tillägg Azure Container Apps Nytt kodutrymme

  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 på länken Nytt kodområde bredvid det mallnamn som du valde och välj Öppna på ny flik för att starta konfigurationsprocessen.

    Under den här processen kan du uppmanas att logga in på ditt GitHub konto. Du uppmanas också 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 webbläsarflik med den Python webbmallen inläst som en arbetsyta i Utforskarvyn.

Autentisera till Azure och distribuera azd-mallen

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

  1. I den webbaserade Visual Studio Code är terminalen öppen som standard. Om den inte är det använder du tilde-nyckeln ~ för att öppna terminalen. Terminalen är som standard 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 för att 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 är exempelwebbappen tillgänglig på det 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 slutfört arbetet med exempelwebbappen använder du azd down för att ta bort alla tjänster som azd up har skapats.

    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 köra azd up 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.

    1. 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

Gör sedan en liten ändring i webbappen och distribuera om den.

  1. Gå tillbaka till webbläsarfliken som innehåller Visual Studio Code. Använd Visual Studio Code Explorer-vyn för att gå till mappen src/templates. Öppna filenindex.html . Hitta 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 är klart uppdaterar du webbläsarfliken med ReleCloud-webbplatsen för att se uppdateringen. Beroende på vilken webbvärdplattform du använder 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 de resurser som mallen skapade genom att köra kommandot azd down .

azd down

Kommandot azd down tar bort de 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 körs tillfälligt och behålls kortsiktigt i ett codespace. Om du planerar att fortsätta arbeta med koden publicerar du 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 Codespaces. Leta efter den som 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 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 prioriterar du lagringen på en lagringsplats.

  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 gå 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 återgår 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 steg:

  • Kör azd down för att ta bort alla resurser som kommandot skapade. Du kan också ta bort resursgruppen som du skapade 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 Delete från snabbmenyn.
  • I Azure-portalen söker du efter Key Vaults. 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 att upprepa stegen i den här snabbstarten. Den här gången när du uppmanas till det väljer du ett enklare namn för din miljö. Försök med ett kort namn, använd gemener, inga siffror, inga versaler och inga specialtecken.
  • När du försöker utföra snabbstartsstegen igen väljer du en annan plats.

En mer omfattande lista över möjliga problem och lösningar finns i Vanliga frågor och svar.

Relaterat innehåll

  • Last updated on