Rychlý start: Vytvoření a nasazení webové aplikace Python z GitHub Codespaces do Azure pomocí šablony rozhraní příkazového řádku pro vývojáře Azure

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

  • Zvolte šablonu Azure Rozhraní příkazového řádku pro vývojáře (azd) na základě webové architektury Python, databázové platformy Azure a Azure platformy pro hostování webů, na které chcete stavět.
  • Vytvořte novou GitHub Codespace obsahující kód vygenerovaný ze šablony azd, kterou jste vybrali.
  • Použijte GitHub Codespaces a online terminál Bash Visual Studio Code. Terminál umožňuje použít příkazy rozhraní příkazového řádku pro vývojáře Azure ke spuštění šablony azd k vytvoření ukázkové webové aplikace a databáze a vytvoření a konfiguraci potřebných Azure prostředků a následné nasazení ukázkové webové aplikace do Azure.
  • Upravte webovou aplikaci v GitHub Codespace a k opětovnému nasazení použijte příkaz azd.
  • K vyčištění Azure prostředků použijte příkaz azd.
  • 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 šablonách azd pro vývoj webových aplikací Python najdete tady:

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. Dodržení tohoto rychlého startu může ovlivnit tyto alokace nebo fakturaci. Pokud je to možné, azd šablony používají nejlevnější úroveň možností, ale některé nemusí být bezplatné. K lepšímu pochopení nákladů použijte cenovou kalkulačku Azure. Další informace naleznete v cenách GitHub Codespaces.

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

Zvolte šablonu azd na základě webové architektury Python, Azure platformy pro hostování webů a Azure databázové platformy, na které chcete stavět.

  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 New Codespace
    azure-django-postgres-flexible-appservice Django Flexibilní server PostgreSQL Azure App Service New Codespace
    azure-django-cosmos-postgres-aca Django Cosmos DB (adaptér PostgreSQL) Azure Container Apps New Codespace
    azure-django-cosmos-postgres-appservice Django Cosmos DB (adaptér PostgreSQL) Azure App Service New Codespace
    Azure Django Postgres Addon ACA Django Azure Container Apps doplněk PostgreSQL Azure Container Apps New Codespace

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

    Během tohoto procesu se může zobrazit výzva, abyste se přihlásili ke svému účtu GitHub. Zobrazí se také výzva k potvrzení, že chcete vytvořit Codespace. Výběrem tlačítka Vytvořit Codespace zobrazíte stránku Nastavení vašeho codespace.

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

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

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

  1. Ve webovém Visual Studio Code je 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í je terminál Bash. Pokud tomu tak není, přepněte na bash v pravém horním rohu okna terminálu.

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

    azd auth login

    azd auth login zahájí ověřování vašeho Codespace k vašemu úč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 Microsoft Azure CLI

  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 Azure předplatné, které chcete použít [K pohybu použijte šipky, pro filtrování pište]
    • Vyberte lokalitu Azure, kterou chcete použít: [Pomocí šipek se pohybujte, pište k filtrování]

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

    Důležité

    Po úspěšném dokončení azd up je 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 všechny služby, které azd up vytvořil, pomocí azd down.

    Postupujte podle pokynů po zobrazení výzvy, abyste zvolili předplatné Azure pro platby a pak vyberte umístění Azure k použití. Zvolte oblast, která je blízko vás geograficky.

    Provádění azd up 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. Počkejte 5 až 10 minut, než zahájíte řešení problémů, abyste zjistili, zda se problém vyřeší sám.

    1. Stisknutím klávesy Ctrl a kliknutím na první adresu URL za slovem - Endpoint: zobrazíte projekt ukázkové 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 portálu Azure.

Úpravy a opětovné nasazení

V dalším kroku proveďte malou změnu webové aplikace a pak ji znovu nasaďte.

  1. Vraťte se na kartu prohlížeče, která obsahuje Visual Studio Code. Pomocí zobrazení Průzkumníka Visual Studio Code přejděte do složky src/templates. Otevřete soubor index.html . Najděte následující řá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 znovu načtěte kartu prohlížeče s webovou stránkou ReleCloud, aby se zobrazila aktualizace. V závislosti na platformě pro hostování webu, kterou používáte, 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čistěte zdroje

Vyčistěte prostředky, které šablona vytvořila 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é: Vyhledat váš codespace

Tato část demonstruje, jak je váš kód v prostředí Codespace dočasně spuštěn a krátkodobě uchován. Pokud plánujete pokračovat v práci na kódu, publikujte ho 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č, otevřete novou kartu a přejděte na https://github.com/codespaces.

  3. Blízko dolní části se zobrazí seznam posledních Codespaces. Vyhledejte ten, který jste vytvořili v oddílu s názvem „Ve vlastnictví 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

Nyní máte Codespace, který je kontejnerem hostovaným na GitHubu a ve kterém běží vaše běhové prostředí Visual Studio Code s novým kódem vytvořeným z šablony azd. Kód ale není uložený v úložišti GitHub. Pokud plánujete pokračovat v práci na kódu, určete prioritu jeho uložení v úložišti.

  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 Create repository (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 průvodci, je pushnut 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. Vrátíte se 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émů

Pokud se během azd up zobrazí chyby, vyzkoušejte následující kroky:

  • Spusťte azd down, abyste odstranili všechny prostředky vytvořené příkazem. Případně můžete odstranit skupinu prostředků, kterou jste vytvořili na portálu Azure.
  • Přejděte na stránku Codespaces pro váš účet GitHub, vyhledejte Codespace vytvořený během tohoto rychlého startu, vyberte tři tečky napravo a v místní nabídce zvolte Delete.
  • Na portálu Azure vyhledejte trezory klíčů. Vyberte 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.
  • Zopakujte kroky v tomto krátkém návodu. 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 a žá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

  • Last updated on