Udostępnij za pomocą

Szybki start: tworzenie i wdrażanie aplikacji internetowej w języku Python na platformie Azure przy użyciu szablonu azd

Ten przewodnik Szybki start przeprowadzi Cię przez najprostszy i najszybszy sposób tworzenia i wdrażania rozwiązania internetowego i bazy danych języka Python na platformie Azure. Postępując zgodnie z instrukcjami w tym przewodniku Szybki start, wykonasz następujące czynności:

  • azd Wybierz szablon oparty na strukturze internetowej języka Python, platformie azure database i platformie hostingu internetowego platformy Azure, na której chcesz opierać się.
  • Użyj poleceń interfejsu wiersza polecenia, aby uruchomić azd szablon, aby utworzyć przykładową aplikację internetową i bazę danych oraz utworzyć i skonfigurować niezbędne zasoby platformy Azure, a następnie wdrożyć przykładową aplikację internetową na platformie Azure.
  • Edytuj aplikację internetową na komputerze lokalnym i użyj azd polecenia , aby ponownie wdrożyć.
  • azd Użyj polecenia , aby wyczyścić zasoby platformy 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 azd szablonach do tworzenia aplikacji internetowych w Pythonie:

Wymagania wstępne

Subskrypcja platformy Azure - Utwórz ją za darmo

Na komputerze lokalnym muszą być zainstalowane następujące elementy:

Wybierz szablon

Wybierz szablon w oparciu o framework internetowy Python, platformę hostingu sieciowego Azure i platformę baz danych Azure, na której chcesz budować.

  1. Wybierz nazwę szablonu (pierwszą kolumnę) z poniższej listy szablonów w poniższych tabelach. W następnej sekcji użyjesz nazwy szablonu azd init.

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

Repozytorium GitHub (ostatnia kolumna) jest udostępniane tylko do celów referencyjnych. Repozytorium należy sklonować tylko bezpośrednio, jeśli chcesz współtworzyć zmiany w szablonie. W przeciwnym razie postępuj zgodnie z instrukcjami w tym przewodniku szybkiego startu, aby użyć wiersza polecenia azd do interakcji z szablonem w normalnym przepływie pracy.

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, a następnie utwórz nowy folder o nazwie azdtest. Następnie przejdź do tego katalogu przy użyciu cd polecenia .

    mkdir azdtest
cd azdtest

    Nie używaj terminalu programu Visual Studio Code dla tego szybkiego startu.

  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 podczas nazewnictwa grup zasobów i zasobów platformy Azure. Aby uzyskać najlepsze wyniki, użyj krótkiej nazwy, małych liter, bez znaków specjalnych.

  3. Aby uwierzytelnić azd się na koncie platformy 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 platformy 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 platformy Azure, wprowadź następujące polecenia w terminalu i odpowiedz na wszelkie monity:

    azd up

    Ważne

    Po azd up pomyślnym zakończeniu przykładowa aplikacja internetowa będzie dostępna w publicznym Internecie, a Subskrypcja platformy Azure rozpocznie 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 platformy Azure do użycia do płatności, a następnie wybierz lokalizację platformy Azure do użycia. Wybierz region, który znajduje się blisko Ciebie geograficznie.

    Wykonanie azd up może potrwać kilka minut, ponieważ wiąże się z aprowizacją i wdrażaniem wielu usług 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 azd down, aby usunąć wszystkie usługi utworzone przez azd up.

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

    Zrzut ekranu przedstawiający pomyślny wynik z interfejsu wiersza polecenia azd z wyróżnieniem wokół adresu URL punktu końcowego w celu wyświetlenia działającej aplikacji Relecloud wdrożonej na platformie Azure.

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

  7. Otwórz nową kartę w przeglądarce internetowej, skopiuj drugi adres URL z poprzedniego kroku i wklej go na pasku lokalizacji. W witrynie Azure Portal zostaną wyświetlone wszystkie usługi w nowej grupie zasobów, które zostały wdrożone w celu hostowania przykładowego projektu aplikacji internetowej.

Edytowanie i ponowne wdrażanie

Następnym krokiem jest wprowadzenie niewielkiej zmiany w aplikacji internetowej, a następnie ponowne wdrożenie.

  1. Otwórz program Visual Studio Code i otwórz utworzony wcześniej folder azdtest .

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

  3. Użyj widoku Eksploratora programu 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, w terminalu uruchom następujące polecenie:

    azd deploy

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

  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 platformy Azure i przepływ pracy funkcji 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, które mogły zostać utworzone. Alternatywnie możesz usunąć grupę zasobów utworzoną w witrynie Azure Portal.
  • Usuń folder azdtest na komputerze lokalnym.
  • W witrynie Azure Portal wyszukaj pozycję Magazyny kluczy. Wybierz opcję Zarządzaj usuniętymi magazynami, wybierz subskrypcję, wybierz wszystkie skrytki kluczy zawierające nazwę azdtest lub jakąkolwiek nazwę środowiska, następnie wybierz opcję Wyczyść.
  • Spróbuj ponownie wykonać kroki opisane 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, bez wielkich liter, bez znaków specjalnych.
  • Podczas ponawiania próby wykonania kroków szybkiego startu wybierz inną lokalizację.

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

Powiązana zawartość

  • Last updated on