Udostępnij za pośrednictwem

Szybki start: jak stworzyć i wdrożyć aplikację internetową w Pythonie do Azure przy użyciu szablonu azd

Ten szybki przewodnik przeprowadzi Cię przez najprostszy i najszybszy sposób tworzenia i wdrażania rozwiązania Python dla aplikacji sieciowych i baz danych na platformę Azure. Postępując zgodnie z instrukcjami w tym przewodniku Szybki start, wykonasz następujące czynności:

  • Wybierz szablon azd na podstawie platformy internetowej Python, platformy bazy danych Azure i platformy hostingu internetowego Azure, na której chcesz budować.
  • Użyj poleceń interfejsu wiersza polecenia, aby uruchomić szablon azd w celu utworzenia przykładowej aplikacji internetowej i bazy danych oraz utworzyć i skonfigurować niezbędne zasoby Azure. Następnie wdróż przykładową aplikację internetową na platformę Azure.
  • Edytuj aplikację internetową na komputerze lokalnym i użyj azd polecenia , aby ponownie wdrożyć.
  • Użyj polecenia azd, aby wyczyścić zasoby Azure.

Ukończenie tego samouczka powinno potrwać mniej niż 15 minut. Po zakończeniu możesz rozpocząć modyfikowanie nowego projektu przy użyciu kodu niestandardowego.

Aby dowiedzieć się więcej o tych szablonach azd na potrzeby tworzenia aplikacji internetowych Python, zobacz:

Wymagania wstępne

Subskrypcja Azure — Utwórz ją bezpłatnie

Zainstaluj następujące narzędzia na komputerze lokalnym:

Wybierz szablon

Wybierz szablon azd w oparciu o framework Python dla aplikacji sieciowych, platformę hostingu Azure Web oraz Azure Database, na której chcesz budować.

  1. Wybierz nazwę szablonu (pierwszą kolumnę) z poniższej listy szablonów w poniższych tabelach. Użyj nazwy szablonu podczas kroku azd init w następnej sekcji.

    Szablon Struktura sieci Web Baza danych Platforma hostingu repozytorium GitHub
    azure-django-postgres-flexible-aca Django Serwer elastyczny PostgreSQL Azure Container Apps repo
    azure-django-postgres-elastyczna-usługa-aplikacji Django Serwer elastyczny PostgreSQL Azure App Service repo
    azure-django-cosmos-postgres-aca Django Cosmos DB (Adapter PostgreSQL) Azure Container Apps repo
    azure-django-cosmos-postgres-appservice Django Cosmos DB (Adapter PostgreSQL) Azure App Service repo
    azure-django-postgres-dodatek-aca Django rozszerzenie PostgreSQL dla Azure Container Apps Azure Container Apps repo

Uruchamianie szablonu

Uruchamianie szablonu azd jest takie samo w różnych językach i strukturach. Te same podstawowe kroki dotyczą wszystkich szablonów. Kroki są następujące:

  1. W terminalu przejdź do folderu na komputerze lokalnym, na którym zwykle są przechowywane lokalne repozytoria git. Utwórz nowy folder o nazwie azdtest. Następnie przejdź do tego katalogu przy użyciu cd polecenia .

    mkdir azdtest
cd azdtest

    Podczas szybkiego startu nie używaj terminalu Visual Studio Code.

  2. Aby skonfigurować lokalne środowisko programistyczne, wprowadź następujące polecenia w terminalu i odpowiedz na wszelkie monity:

    azd init --template <template name>

    Zastąp <template name> jednym z szablonów z tabel, które wybrałeś w poprzednim kroku, na przykład azure-django-postgres-aca.

    Po opytaniu o nazwę środowiska, korzystaj z azdtest lub innej nazwy. Nazwa środowiska jest używana przy nadawaniu nazw grupom zasobów i zasobom na platformie Azure. Aby uzyskać najlepsze wyniki, użyj krótkiej nazwy, małych liter, bez znaków specjalnych.

  3. Aby uwierzytelnić azd na koncie Azure, wprowadź następujące polecenia w terminalu i postępuj zgodnie z monitem:

    azd auth login

    Postępuj zgodnie z instrukcjami po wyświetleniu monitu o wybranie konta lub zalogowanie się do konta Azure. Po pomyślnym uwierzytelnieniu na stronie internetowej zostanie wyświetlony następujący komunikat: "Uwierzytelnianie zostało ukończone. Możesz wrócić do aplikacji. Możesz zamknąć tę kartę przeglądarki.

    Gdy zamkniesz kartę, powłoka wyświetli komunikat:

    Logged in to Azure.

  4. Przed podjęciem następnej próby upewnij się, że program Docker Desktop jest otwarty i uruchomiony w tle.

  5. Aby utworzyć niezbędne zasoby Azure, wprowadź następujące polecenia w terminalu i odpowiedz na wszelkie monity.

    azd up

    Ważne

    Po pomyślnym zakończeniu azd up przykładowa aplikacja internetowa jest dostępna w publicznym Internecie, a subskrypcja Azure rozpoczyna naliczanie opłat za wszystkie utworzone zasoby. Twórcy azd szablonów celowo wybrali niedrogie warstwy, ale niekoniecznie warstwy bezpłatne , ponieważ warstwy bezpłatne często mają ograniczoną dostępność.

    Postępuj zgodnie z instrukcjami po wyświetleniu monitu o wybranie subskrypcji Azure do użycia na potrzeby płatności, a następnie wybierz lokalizację Azure do użycia. Wybierz region, który znajduje się blisko Ciebie geograficznie.

    Uruchamianie azd up może potrwać kilka minut, ponieważ aprowizacja i wdrażanie wielu usług w ramach Azure. W miarę wyświetlania postępu obserwuj błędy. Jeśli widzisz błędy, spróbuj rozwiązać ten problem:

    • Usuń folder azd-quickstart i instrukcje szybkiego startu od początku.
    • Po wyświetleniu monitu wybierz prostszą nazwę środowiska. Używaj tylko małych liter i kreski. Brak cyfr, wielkich liter ani znaków specjalnych.
    • Wybierz inną lokalizację.

    Jeśli nadal występują problemy, zobacz sekcję Rozwiązywanie problemów w dolnej części tego dokumentu.

    Ważne

    Po zakończeniu pracy z przykładową aplikacją internetową użyj polecenia azd down , aby usunąć wszystkie utworzone usługi azd up .

  6. Po pomyślnym zakończeniu azd up zostaną wyświetlone następujące dane wyjściowe.

    Zrzut ekranu przedstawiający pomyślne wyniki z interfejsu wiersza poleceń azd z wyróżnieniem wokół adresu URL punktu końcowego, aby zobaczyć działającą aplikację Relecloud wdrożoną w Azure.

    Skopiuj pierwszy adres URL po - Endpoint: i wklej go na pasku lokalizacji przeglądarki internetowej, aby zobaczyć przykładowy projekt aplikacji internetowej uruchomiony na żywo w Azure.

  7. Otwórz nową kartę w przeglądarce internetowej.

    1. Skopiuj drugi adres URL z poprzedniego kroku i wklej go na pasku lokalizacji.
    2. W portalu Azure są wyświetlane wszystkie usługi w nowej grupie zasobów wdrożone w celu hostowania przykładowego projektu aplikacji internetowej.

Edytowanie i ponowne wdrażanie

Następnie wprowadź niewielką zmianę w aplikacji internetowej, a następnie ponownie ją wdróż.

  1. Otwórz Visual Studio Code i otwórz folder azdtest.

  2. Ten szablon jest skonfigurowany do opcjonalnego używania usługi Dev Containers. Po wyświetleniu powiadomienia Kontener deweloperski w Visual Studio Code wybierz przycisk Otwórz w kontenerze.

  3. Użyj widoku Eksploratora Visual Studio Code, aby przejść do folderu src/templates i otworzyć plik index.html. Znajdź następujący wiersz kodu:

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

    Zmień tekst wewnątrz H1:

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

    Zapisz zmiany.

  4. Aby ponownie wdrożyć aplikację przy użyciu zmiany, uruchom następujące polecenie w terminalu:

    azd deploy

    Ponieważ używasz kontenerów deweloperskich i łączysz się zdalnie z powłoką kontenera, nie używaj okienka terminalu Visual Studio Code do uruchamiania poleceń azd.

  5. Po zakończeniu działania polecenia odśwież przeglądarkę internetową, aby wyświetlić aktualizację. W zależności od używanej platformy hostingu internetowego może upłynąć kilka minut, zanim zmiany będą widoczne.

    Teraz możesz edytować i usuwać pliki w szablonie. Aby uzyskać więcej informacji, zobacz Co mogę edytować lub usunąć w szablonie?

Uprzątnij zasoby

  1. Wyczyść zasoby utworzone przez szablon, uruchamiając azd down polecenie .

    azd down

    Polecenie azd down usuwa zasoby Azure i przepływ pracy GitHub Actions. Po wyświetleniu monitu zaakceptuj usunięcie wszystkich zasobów skojarzonych z grupą zasobów.

    Możesz również usunąć folder azdtest lub użyć go jako podstawy dla własnej aplikacji, modyfikując pliki projektu.

Rozwiązywanie problemów

Jeśli wystąpią błędy podczas azd up, spróbuj wykonać następujące czynności:

  • Uruchom polecenie azd down , aby usunąć wszystkie zasoby utworzone przez polecenie . Alternatywnie możesz usunąć grupę zasobów utworzoną w portalu Azure.
  • Usuń folder azdtest na komputerze lokalnym.
  • W portalu Azure wyszukaj Key Vaulty. Wybierz pozycję Zarządzaj usuniętymi magazynami, wybierz subskrypcję, wybierz wszystkie magazyny kluczy zawierające nazwę azdtest lub jakąkolwiek inną nazwę, którą nadałeś swojemu środowisku, a następnie wybierz pozycję Usuń całkowicie.
  • Ponów próbę wykonania kroków w tym przewodniku Szybki start. Tym razem po wyświetleniu monitu wybierz prostszą nazwę środowiska. Spróbuj użyć krótkiej nazwy, małych liter, bez cyfr, wielkich liter i bez znaków specjalnych.
  • Podczas ponawiania próby wykonania kroków szybkiego startu wybierz inną lokalizację.

Aby uzyskać bardziej kompleksową listę możliwych problemów i rozwiązań, zobacz często zadawane pytania.

Treści powiązane

  • Last updated on