Delen via

Quickstart: Een Python-web-app maken en implementeren in Azure met behulp van een azd-sjabloon

In deze quickstart wordt u begeleid bij de eenvoudigste en snelste manier om een Python web- en databaseoplossing te maken en te implementeren voor Azure. Door de instructies in deze quickstart te volgen, gaat u als volgt te werk:

  • Kies een azd-sjabloon op basis van het Python webframework, Azure databaseplatform en Azure webhostingplatform waarop u wilt bouwen.
  • Gebruik CLI-opdrachten om een azd-sjabloon uit te voeren om een voorbeeldweb-app en -database te maken en de benodigde Azure resources te maken en te configureren. Implementeer vervolgens de voorbeeldweb-app in Azure.
  • Bewerk de web-app op uw lokale computer en gebruik een azd opdracht om opnieuw te implementeren.
  • Gebruik een opdracht azd om Azure resources op te schonen.

Het duurt minder dan 15 minuten om deze zelfstudie te voltooien. Wanneer u klaar bent, kunt u beginnen met het wijzigen van het nieuwe project met uw aangepaste code.

Zie voor meer informatie over deze azd-sjablonen voor het ontwikkelen van Python web-apps:

Vereiste voorwaarden

Een Azure-abonnement - Maak er gratis een

Installeer de volgende hulpprogramma's op uw lokale computer:

Kies een sjabloon

Kies een azd-sjabloon op basis van het Python webframework, Azure webhostingplatform en Azure databaseplatform waarop u wilt bouwen.

  1. Selecteer een sjabloonnaam (eerste kolom) in de volgende lijst met sjablonen in de volgende tabellen. Gebruik de sjabloonnaam tijdens de azd init stap in de volgende sectie.

    Sjabloon Webframework gegevensbank Hostingplatform GitHub repository
    Azure-Django-Postgres-Flexible-ACA Django PostgreSQL Flexibele Server Azure Container Apps repo
    azure-django-postgres-flexible-appservice Django PostgreSQL Flexible Server Azure App Service repo
    azure-django-cosmos-postgres-aca Django Cosmos DB (PostgreSQL-adapter) Azure Container Apps repo
    azure-django-cosmos-postgres-appservice Django Cosmos DB (PostgreSQL-adapter) Azure App Service repo
    azure-django-postgres-addon-aca Django Azure Container Apps PostgreSQL-invoegtoepassing Azure Container Apps repo

De sjabloon uitvoeren

Het uitvoeren van een azd sjabloon is hetzelfde in verschillende talen en frameworks. Dezelfde basisstappen zijn van toepassing op alle sjablonen. De stappen zijn:

  1. Navigeer in een terminal naar een map op uw lokale computer waar u doorgaans uw lokale Git-opslagplaatsen opslaat. Maak een nieuwe map met de naam azdtest. Verander vervolgens naar die map met behulp van de cd-opdracht.

    mkdir azdtest
cd azdtest

    Gebruik de terminal van Visual Studio Code niet voor deze quickstart.

  2. Als u de lokale ontwikkelomgeving wilt instellen, voert u de volgende opdrachten in uw terminal in en beantwoordt u eventuele prompts:

    azd init --template <template name>

    Vervang <template name> deze door een van de sjablonen uit de tabellen die u in een vorige stap hebt geselecteerd, zoals bijvoorbeeld azure-django-postgres-aca .

    Wanneer u wordt gevraagd om een omgevingsnaam, gebruikt u azdtest of een andere naam. De omgevingsnaam wordt gebruikt bij het benoemen van Azure-resourcegroepen en resources. Gebruik voor de beste resultaten een korte naam, kleine letters, geen speciale tekens.

  3. Als u azd wilt verifiëren bij uw Azure-account, voert u de volgende opdrachten in uw terminal in en volgt u de prompt:

    azd auth login

    Volg de instructies wanneer u wordt gevraagd een account te kiezen of u aan te melden bij uw Azure-account. Zodra u bent geverifieerd, wordt het volgende bericht weergegeven op een webpagina: 'Verificatie voltooid. U kunt terugkeren naar de toepassing. U kunt dit browsertabblad gerust sluiten."

    Wanneer u het tabblad sluit, wordt in de shell het bericht weergegeven:

    Logged in to Azure.

  4. Zorg ervoor dat Docker Desktop op de achtergrond is geopend en uitgevoerd voordat u de volgende stap uitvoert.

  5. Als u de benodigde Azure resources wilt maken, voert u de volgende opdrachten in uw terminal in en beantwoordt u eventuele prompts:

    azd up

    Belangrijk

    Zodra azd up succesvol is voltooid, is de voorbeeldweb-app beschikbaar op het openbare internet en begint uw Azure-abonnement kosten op te bouwen voor alle resources die worden gemaakt. De makers van de azd sjablonen hebben opzettelijk goedkope lagen gekozen, maar niet noodzakelijkerwijs gratis lagen, omdat gratis lagen vaak beperkte beschikbaarheid hebben.

    Volg de instructies wanneer u wordt gevraagd om Azure Abonnement te kiezen voor betaling en selecteer vervolgens een Azure locatie die u wilt gebruiken. Kies een regio die zich geografisch bij u in de buurt bevindt.

    Het uitvoeren van azd up kan enkele minuten duren, omdat er meerdere Azure-services worden ingericht en geïmplementeerd. Wanneer de voortgang wordt weergegeven, let op fouten. Als u fouten ziet, probeert u het volgende om het probleem op te lossen:

    • Verwijder de map azd-quickstart en de quickstart-instructies vanaf het begin.
    • Wanneer u hierom wordt gevraagd, kiest u een eenvoudigere naam voor uw omgeving. Gebruik alleen kleine letters en streepjes. Geen cijfers, hoofdletters of speciale tekens.
    • Kies een andere locatie.

    Als u nog steeds problemen ondervindt, raadpleegt u de sectie Probleemoplossing onderaan dit document.

    Belangrijk

    Wanneer u klaar bent met het werken aan de voorbeeld webapp, gebruikt u azd down om alle services te verwijderen die door azd up zijn gemaakt.

  6. Wanneer azd up de bewerking is voltooid, wordt de volgende uitvoer weergegeven:

    Schermafbeelding van geslaagde uitvoer van de azd-commandoregelinterface met een aanduiding rond de eindpunt-URL om de werkende Relecloud-toepassing te bekijken die in Azure is geïmplementeerd.

    Kopieer de eerste URL na het woord - Endpoint: en plak deze in de locatiebalk van een webbrowser om het voorbeeldweb-app-project live uit te voeren in Azure.

  7. Open een nieuw tabblad in uw webbrowser.

    1. Kopieer de tweede URL uit de vorige stap en plak deze in de locatiebalk.
    2. In de Azure-portal worden alle services in uw nieuwe resourcegroep weergegeven die zijn geïmplementeerd om het voorbeeldweb-app-project te hosten.

Bewerken en opnieuw implementeren

Breng vervolgens een kleine wijziging aan in de web-app en implementeer deze opnieuw.

  1. Open Visual Studio Code en open de map azdtest.

  2. Deze sjabloon is geconfigureerd om optioneel Dev Containers te gebruiken. Wanneer u de Dev Container-melding in Visual Studio Code ziet, selecteert u de knop Heropenen in Container.

  3. Gebruik de verkennerweergave van Visual Studio Code om naar de map src/templates te navigeren en het bestand index.html te openen. Zoek de volgende coderegel:

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

    Wijzig de tekst in de H1:

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

    Sla uw wijzigingen op.

  4. Als u de app opnieuw wilt implementeren met uw wijziging, voert u de volgende opdracht uit in uw terminal:

    azd deploy

    Omdat u Dev Containers gebruikt en op afstand bent verbonden met de shell van de container, gebruikt u het terminalvenster van Visual Studio Code niet om azd-opdrachten uit te voeren.

  5. Wanneer de opdracht is voltooid, vernieuwt u de webbrowser om de update te zien. Afhankelijk van het webhostingplatform dat u gebruikt, kan het enkele minuten duren voordat uw wijzigingen zichtbaar zijn.

    U kunt nu bestanden in de sjabloon bewerken en verwijderen. Zie Wat kan ik bewerken of verwijderen in de sjabloon voor meer informatie?

De hulpbronnen opschonen

  1. Schoon de resources op die door de sjabloon zijn gemaakt door de azd down opdracht uit te voeren.

    azd down

    Met de opdracht azd down worden de Azure resources en de GitHub Actions-werkstroom verwijderd. Wanneer u hierom wordt gevraagd, gaat u akkoord met het verwijderen van alle resources die zijn gekoppeld aan de resourcegroep.

    U kunt ook de map azdtest verwijderen of gebruiken als basis voor uw eigen toepassing door de bestanden van het project te wijzigen.

Probleemoplossingsproces

Als er fouten optreden tijdens azd up, probeer dan de volgende stappen:

  • Voer deze opdracht uit azd down om alle resources te verwijderen die door de opdracht zijn gemaakt. U kunt ook de resourcegroep verwijderen die u hebt gemaakt in de Azure-portal.
  • Verwijder de map azdtest op uw lokale computer.
  • Zoek in de Azure-portal naar Key Vaults. Selecteer Verwijderde kluizen beheren, kies uw abonnement, selecteer alle sleutelkluizen die de naam azdtest of de naam van uw omgeving bevatten en selecteer Leegmaken.
  • Voer de stappen in deze quickstart opnieuw uit. Wanneer u hierom wordt gevraagd, kiest u een eenvoudigere naam voor uw omgeving. Probeer een korte naam, kleine letters, geen cijfers, geen hoofdletters en geen speciale tekens.
  • Wanneer u de quickstartstappen opnieuw probeert, kiest u een andere locatie.

Zie de veelgestelde vragen voor een uitgebreidere lijst met mogelijke problemen en oplossingen.

Verwante inhoud

  • Last updated on