Sdílet prostřednictvím

Rychlý start: Vytvoření a nasazení webové aplikace v Pythonu z GitHub Codespaces do Azure pomocí šablony Azure Developer CLI

  • Článek

Tento rychlý start vás provede nejjednodušším a nejrychlejším způsobem, jak vytvořit a nasadit webové a databázové řešení Pythonu do Azure. Podle pokynů v tomto rychlém startu:

  • Zvolte šablonu Azure Developer CLI (azd) na základě webové architektury Pythonu, databázové platformy Azure a platformy pro hostování webů Azure, na které chcete stavět.
  • Vytvořte nový kód GitHub Codespace obsahující kód vygenerovaný z azd vybrané šablony.
  • Použijte GitHub Codespaces a online terminál Bash editoru Visual Studio Code. Terminál umožňuje použít příkazy Azure Developer CLI ke spuštění azd šablony k vytvoření ukázkové webové aplikace a databáze a vytvoření a konfiguraci potřebných prostředků Azure a následné nasazení ukázkové webové aplikace do Azure.
  • Upravte webovou aplikaci v Prostředí Codespace GitHubu a použijte azd příkaz k opětovnému nasazení.
  • azd K vyčištění prostředků Azure použijte příkaz.
  • Zavřete a znovu otevřete GitHub Codespace.
  • Publikujte nový kód do úložiště GitHub.

Dokončení tohoto kurzu by mělo trvat méně než 25 minut. Po dokončení můžete začít upravovat nový projekt pomocí vlastního kódu.

Další informace o těchto azd šablonách pro vývoj webových aplikací v Pythonu:

Požadavky

Důležité

GitHub Codespaces i Azure jsou placené služby založené na předplatných. Po několika bezplatných přiděleních se vám můžou účtovat poplatky za používání těchto služeb. Po provedení tohoto rychlého startu může mít vliv na tyto přidělení nebo fakturaci. Pokud je to možné, azd šablony byly vytvořeny s použitím nejméně nákladné úrovně možností, ale některé nemusí být bezplatné. Pokud chcete lépe porozumět nákladům, použijte cenovou kalkulačku Azure. Další informace najdete v tématu o cenách GitHub Codespaces.

Volba šablony a vytvoření prostoru kódu

azd Zvolte šablonu založenou na webové platformě Pythonu, platformě pro hostování webů Azure a na databázové platformě Azure, na které chcete vytvářet.

  1. V následujícím seznamu šablon vyberte šablonu, která používá technologie, které chcete použít v nové webové aplikaci.

    Šablona Webová architektura Databáze Platforma hostování Nový Codespace
    azure-django-postgres-flexible-aca Django Flexibilní server PostgreSQL Azure Container Apps Nový Codespace
    azure-django-postgres-flexible-appservice Django Flexibilní server PostgreSQL Azure App Service Nový Codespace
    azure-django-cosmos-postgres-aca Django Cosmos DB (adaptér PostgreSQL) Azure Container Apps Nový Codespace
    azure-django-cosmos-postgres-appservice Django Cosmos DB (adaptér PostgreSQL) Azure App Service Nový Codespace
    azure-django-postgres-addon-aca Django Doplněk PostgreSQL pro Azure Container Apps Azure Container Apps Nový Codespace

  1. Poslední sloupec každé tabulky obsahuje pro usnadnění práci odkaz, který vytvoří nový Codespace a inicializuje azd šablonu ve vašem účtu GitHubu. Klikněte pravým tlačítkem myši a vyberte Otevřít v nové kartě na odkazu Nový codespace vedle názvu šablony, který jste vybrali pro zahájení procesu nastavení.

    Během tohoto procesu se může zobrazit výzva k přihlášení ke svému účtu GitHubu a zobrazí se výzva k potvrzení, že chcete vytvořit Codespace. Výběrem tlačítka Vytvořit codespace zobrazíte stránku Nastavení kódu.

  2. Po několika minutách se webová verze editoru Visual Studio Code načte na nové kartě prohlížeče s webovou šablonou Pythonu načtenou jako pracovní prostor v zobrazení Průzkumníka.

Ověření v Azure a nasazení šablony azd

Teď, když máte GitHub Codespace obsahující nově vygenerovaný kód, použijete azd nástroj z Codespace k publikování kódu do Azure.

  1. Ve webovém editoru Visual Studio Code by měl být terminál ve výchozím nastavení otevřený. Pokud tomu tak není, otevřete terminál pomocí klíče tilda ~ . Ve výchozím nastavení by měl být terminál Bash. Pokud tomu tak není, změňte bash v pravé horní části okna terminálu.

  2. V terminálu Bash zadejte následující příkaz:

    azd auth login

    azd auth login zahájí proces ověřování vašeho Codespace ve vašem účtu Azure.

    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. Postupujte podle pokynů, které zahrnují:

    • Kopírování vygenerovaného kódu
    • Výběrem klávesy Enter otevřete novou kartu prohlížeče a vložíte kód do textového pole.
    • Výběr účtu Azure ze seznamu
    • Potvrzení, že se pokoušíte přihlásit k Rozhraní příkazového řádku Microsoft Azure

  4. Po úspěšném dokončení se na kartě Codespaces v terminálu zobrazí následující zpráva:

    Device code authentication completed.
Logged in to Azure.

  5. Novou aplikaci nasaďte do Azure zadáním následujícího příkazu:

    azd up

    Během tohoto procesu budete vyzváni k:

    • Zadejte nový název prostředí.
    • Vyberte předplatné Azure, které se má použít [Použití šipek k přesunutí, zadání k filtrování]
    • Vyberte umístění Azure, které chcete použít: [Použijte šipky k přesunutí, typ k filtrování]

    Jakmile na tyto otázky odpovíte, výstup z azd indikuje, že nasazení postupuje.

    Důležité

    Po azd up úspěšném dokončení bude ukázková webová aplikace dostupná na veřejném internetu a vaše předplatné Azure začne účtovat poplatky za všechny vytvořené prostředky. Tvůrci azd šablon záměrně zvolili levné úrovně, ale ne nutně úrovně Free , protože úrovně Free mají často omezenou dostupnost. Po dokončení práce s ukázkovou webovou aplikací odeberte azd down všechny služby, které vytvořil azd up.

    Postupujte podle pokynů po zobrazení výzvy k výběru předplatného Azure, které se má použít k platbě, a pak vyberte umístění Azure, které chcete použít. Zvolte oblast, která je blízko vás geograficky.

    azd up Spuštění může trvat několik minut, protože zřizuje a nasazuje několik služeb Azure. Jak se zobrazuje průběh, sledujte chyby. Pokud se zobrazí chyby, přečtěte si část Řešení potíží v dolní části tohoto dokumentu.

  6. Po azd up úspěšném dokončení se zobrazí podobný výstup:

    (✓) 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

    Pokud se zobrazí výchozí obrazovka nebo chybová obrazovka, může se aplikace spustit. Než se problém vyřeší, počkejte 5 až 10 minut, než se problém vyřeší.

    Ctrl + kliknutím na první adresu URL za slovem - Endpoint: zobrazíte ukázkový projekt webové aplikace spuštěný živě v Azure.

  7. Stisknutím klávesy Ctrl a kliknutím na druhou adresu URL z předchozího kroku zobrazíte zřízené prostředky na webu Azure Portal.

Úpravy a opětovné nasazení

Dalším krokem je provedení malé změny webové aplikace a následné opětovné nasazení.

  1. Vraťte se na kartu prohlížeče obsahující Visual Studio Code a pomocí zobrazení Průzkumníka editoru Visual Studio Code přejděte do složky src/templates a otevřete soubor index.html . Najděte tento řádek kódu:

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

    Změňte text uvnitř H1:

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

    Váš kód se uloží při psaní.

  2. Pokud chcete aplikaci znovu nasadit se změnou, spusťte v terminálu následující příkaz:

    azd deploy

  3. Po dokončení příkazu aktualizujte kartu prohlížeče webem ReleCloud, aby se aktualizace zobrazila. V závislosti na používané platformě pro hostování webu může trvat několik minut, než se změny zobrazí.

    Teď jste připraveni upravovat a odstraňovat soubory v šabloně. Další informace najdete v tématu Co můžu v šabloně upravit nebo odstranit?

Vyčištění prostředků

Vyčistěte prostředky vytvořené šablonou spuštěním příkazu azd down .

azd down

Příkaz azd down odstraní prostředky Azure a pracovní postup GitHub Actions. Po zobrazení výzvy přijměte souhlas s odstraněním všech prostředků přidružených ke skupině prostředků.

Volitelné: Vyhledání prostředí codespace

Tato část ukazuje, jak je váš kód (dočasně) spuštěný a trvalý krátkodobý v Codespace. Pokud plánujete pokračovat v práci na kódu, měli byste tento kód publikovat do nového úložiště.

  1. Zavřete všechny karty související s tímto článkem Rychlého startu nebo úplně vypněte webový prohlížeč.

  2. Otevřete webový prohlížeč a novou kartu a přejděte na: https://github.com/codespaces

  3. V dolní části se zobrazí seznam posledních codespaces. Vyhledejte ten, který jste vytvořili v oddílu s názvem Vlastněné službou Azure-Samples.

  4. Výběrem tří teček napravo od tohoto codespace zobrazíte místní nabídku. Odtud můžete přejmenovat codespace, publikovat do nového úložiště, změnit typ počítače, zastavit codespace a další.

Volitelné: Publikování úložiště GitHub z Codespaces

V tuto chvíli máte Codespace, což je kontejner hostovaný GitHubem, ve kterém běží vývojové prostředí editoru Visual Studio Code s novým kódem vygenerovaným ze azd šablony. Kód ale není uložený v úložišti GitHub. Pokud plánujete pokračovat v práci na kódu, měli byste nastavit prioritu.

  1. V místní nabídce pro codespace vyberte Publikovat do nového úložiště.
  2. V dialogovém okně Publikovat do nového úložiště přejmenujte nové úložiště a zvolte, jestli má být veřejným nebo privátním úložištěm. Vyberte Vytvořit úložiště.
  3. Po chvíli se úložiště vytvoří a kód, který jste vygenerovali dříve v tomto rychlém startu, se nasdílí do nového úložiště. Výběrem tlačítka Zobrazit úložiště přejděte do nového úložiště.
  4. Pokud chcete znovu otevřít a pokračovat v úpravách kódu, vyberte zelený<> rozevírací seznam Code, přepněte na kartu Codespaces a vyberte název codespace, na které jste dříve pracovali. Teď byste měli být vráceni do vývojového prostředí Codespace visual Studio Code.
  5. Pomocí podokna Správa zdrojového kódu vytvořte nové větve a fázi a potvrďte nové změny kódu.

Řešení problému

Pokud se během této doby azd upzobrazí chyby, zkuste následující:

  • Spuštěním odeberte azd down všechny prostředky, které mohly být vytvořeny. Případně můžete odstranit skupinu prostředků vytvořenou na webu Azure Portal.
  • Přejděte na stránku Codespaces pro váš účet GitHubu, vyhledejte Codespace vytvořený během tohoto rychlého startu, vyberte tři tečky napravo a v místní nabídce zvolte Odstranit.
  • Na webu Azure Portal vyhledejte trezory klíčů. Vyberte možnost Spravovat odstraněné trezory, zvolte své předplatné, vyberte všechny trezory klíčů, které obsahují název azdtest nebo cokoli, co jste pojmenovali své prostředí, a vyberte Vyprázdnit.
  • Opakujte kroky v tomto rychlém startu znovu. Tentokrát po zobrazení výzvy zvolte pro vaše prostředí jednodušší název. Zkuste krátký název, malá písmena, žádná čísla, velká písmena, žádné speciální znaky.
  • Při opakování kroků rychlého startu zvolte jiné umístění.

Podrobnější seznam možných problémů a řešení najdete v nejčastějších dotazech.

Související obsah