Udostępnij za pośrednictwem

Szybki start: utworzenie i wdrożenie aplikacji webowej w Pythonie z GitHub Codespaces do Azure przy użyciu szablonu Azure Developer CLI

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 interfejsu wiersza polecenia dewelopera Azure (azd) na podstawie platformy internetowej Python, platformy bazy danych Azure i platformy hostingu internetowego Azure, na której chcesz utworzyć.
  • Utwórz nowy GitHub Codespace zawierający kod wygenerowany na podstawie wybranego szablonu azd.
  • Użyj GitHub Codespaces i terminala bash online według Visual Studio Code. Terminal umożliwia korzystanie z poleceń interfejsu wiersza polecenia dla deweloperów Azure do uruchamiania szablonu azd w celu stworzenia przykładowej aplikacji internetowej i bazy danych, a także tworzenia i konfigurowania niezbędnych zasobów Azure, a następnie wdrażania przykładowej aplikacji internetowej do platformy Azure.
  • Edytuj aplikację internetową w GitHub Codespace i użyj polecenia azd w celu ponownego wdrożenia.
  • Użyj polecenia azd, aby wyczyścić zasoby Azure.
  • Zamknij i otwórz ponownie GitHub Codespace.
  • Opublikuj nowy kod w repozytorium GitHub.

Ukończenie tego samouczka powinno potrwać mniej niż 25 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

Ważne

Zarówno GitHub Codespaces, jak i Azure są płatnymi usługami opartymi na subskrypcjach. Po niektórych bezpłatnych przydziałach mogą być naliczane opłaty za korzystanie z tych usług. Korzystanie z tego szybkiego startu może wpłynąć na te przydziały lub rozliczenia. Jeśli to możliwe, azd szablony używają najmniej kosztownej warstwy opcji, ale niektóre mogą nie być bezpłatne. Użyj kalkulatora cen Azure aby lepiej zrozumieć koszty. Aby uzyskać więcej informacji, zobacz cennik GitHub Codespaces.

Wybieranie szablonu i tworzenie przestrzeni kodu

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

  1. Z poniższej listy szablonów wybierz jeden, który używa technologii, które mają być używane w nowej aplikacji internetowej.

    Szablon Struktura sieci Web Baza danych Platforma hostingu Nowa przestrzeń kodu
    azure-django-postgres-flexible-aca Django Serwer elastyczny PostgreSQL Azure Container Apps Nowa przestrzeń kodowa
    azure-django-postgres-elastyczna-usługa-aplikacji Django Serwer elastyczny PostgreSQL Azure App Service Nowy Codespace
    azure-django-cosmos-postgres-aca Django Cosmos DB (Adapter PostgreSQL) Azure Container Apps Nowa przestrzeń kodowa
    azure-django-cosmos-postgres-appservice Django Cosmos DB (Adapter PostgreSQL) Azure App Service Nowa przestrzeń kodu
    azure-django-postgres-dodatek-aca Django Dodatek Azure Container Apps PostgreSQL Azure Container Apps Nowa przestrzeń kodu

  1. Dla wygody ostatnia kolumna każdej tabeli zawiera link, który tworzy nową przestrzeń kodu i inicjuje szablon azd na koncie GitHub. Kliknij prawym przyciskiem myszy link New Codespace obok wybranej nazwy szablonu i wybierz pozycję Otwórz na nowej karcie, aby zainicjować proces instalacji.

    Podczas tego procesu może zostać wyświetlony monit o zalogowanie się do konta GitHub. Zostaniesz również poproszony o potwierdzenie, że chcesz utworzyć Codespace. Wybierz przycisk Utwórz przestrzeń kodu , aby wyświetlić stronę Konfigurowanie przestrzeni kodu .

  2. Po kilku minutach internetowa wersja Visual Studio Code zostanie załadowana na nowej karcie przeglądarki z szablonem sieci Web Python załadowanym jako obszar roboczy w widoku Eksploratora.

Uwierzytelnianie w Azure i wdrażanie szablonu azd

Teraz, kiedy posiadasz GitHub Codespace zawierający nowo wygenerowany kod, użyj narzędzia azd z Codespace, aby opublikować kod do Azure.

  1. W wersji przeglądarkowej Visual Studio Code terminal jest otwarty domyślnie. Jeśli tak nie jest, użyj klawisza tyldy ~ aby otworzyć terminal. Domyślnie terminal używa powłoki bash. Jeśli tak nie jest, przejdź do powłoki bash w prawym górnym obszarze okna terminalu.

  2. W terminalu Bash wprowadź następujące polecenie:

    azd auth login

    azd auth login rozpoczyna uwierzytelnianie aplikacji Codespace na koncie 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. Postępuj zgodnie z instrukcjami, które obejmują:

    • Kopiowanie wygenerowanego kodu
    • Wybranie klawisza Enter w celu otwarcia nowej karty przeglądarki i wklejenia kodu w polu tekstowym
    • Wybieranie konta Azure z listy
    • Potwierdzanie, że próbujesz zalogować się do usługi Microsoft Azure CLI

  4. Po pomyślnym wykonaniu, następujący komunikat zostanie wyświetlony na karcie Codespaces w terminalu:

    Device code authentication completed.
Logged in to Azure.

  5. Wdróż nową aplikację w Azure, wprowadzając następujące polecenie:

    azd up

    Podczas tego procesu zostaniesz poproszony o:

    • Wprowadź nową nazwę środowiska
    • Wybierz subskrypcję Azure, aby użyć [Użyj strzałek do przeniesienia, wpisz filtr]
    • Wybierz lokalizację Azure do użycia: [Użyj strzałek do przeniesienia, wpisz filtr]

    Po odpowiedzi na te pytania wynik z azd oznacza rozpoczęcie implementacji.

    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ść. Po zakończeniu pracy z przykładową aplikacją internetową użyj polecenia azd down , aby usunąć wszystkie utworzone usługi azd up .

    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, zobacz sekcję Rozwiązywanie problemów w dolnej części tego dokumentu.

  6. Gdy azd up zakończy się pomyślnie, zostanie wyświetlony podobny wynik:

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

    Jeśli zostanie wyświetlony ekran domyślny lub ekran błędu, aplikacja może być uruchamiana. Poczekaj 5–10 minut, aby sprawdzić, czy problem rozwiąże się przed rozwiązaniem problemu.

    1. Ctrl + kliknij pierwszy adres URL po wyrazie - Endpoint:, aby zobaczyć przykładowy projekt aplikacji internetowej uruchomiony na żywo w Azure.

  7. Ctrl + kliknij drugi adres URL z poprzedniego kroku, aby wyświetlić zaaprowizowane zasoby w portalu Azure.

Edytowanie i ponowne wdrażanie

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

  1. Wróć do karty przeglądarki zawierającej Visual Studio Code. Użyj widoku Eksploratora Visual Studio Code, aby przejść do folderu src/templates. Otwórz plik index.html . Znajdź następujący wiersz kodu:

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

    Zmień tekst wewnątrz H1:

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

    Kod jest zapisywany podczas wpisywania.

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

    azd deploy

  3. Po zakończeniu działania polecenia odśwież kartę przeglądarki za pomocą witryny internetowej ReleCloud, 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

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

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.

Opcjonalnie: Znajdź swoją przestrzeń kodu

W tej sekcji pokazano, jak kod jest tymczasowo uruchomiony i utrwalany krótkoterminowo w środowisku Codespace. Jeśli planujesz kontynuować pracę nad kodem, opublikuj kod w nowym repozytorium.

  1. Zamknij wszystkie karty związane z tym artykułem Szybki start lub całkowicie zamknij przeglądarkę internetową.

  2. Otwórz przeglądarkę internetową i nową kartę, a następnie przejdź do strony https://github.com/codespaces.

  3. Na dole widzisz listę ostatnich obszarów Codespaces. Poszukaj tego, które utworzyłeś w sekcji zatytułowanej "jest własnością Azure-Samples".

  4. Wybierz wielokropek po prawej stronie tej przestrzeni kodu, aby wyświetlić menu kontekstowe. W tym miejscu możesz zmienić nazwę przestrzeni kodu, opublikować w nowym repozytorium, zmienić typ maszyny, zatrzymać przestrzeń kodu i nie tylko.

Opcjonalnie: Publikowanie repozytorium GitHub z poziomu usługi Codespaces

Na tym etapie masz środowisko Codespace, które jest kontenerem hostowanym przez GitHub i uruchamiającym środowisko deweloperskie Visual Studio Code z nowym kodem wygenerowanym z szablonu azd. Jednak kod nie jest przechowywany w repozytorium GitHub. Jeśli planujesz kontynuować pracę nad kodem, określ priorytety przechowywania go w repozytorium.

  1. Z menu kontekstowego przestrzeni kodu wybierz pozycję Publikuj w nowym repozytorium.
  2. W oknie dialogowym Publikowanie w nowym repozytorium zmień nazwę nowego repozytorium i wybierz, czy ma to być repozytorium publiczne, czy prywatne. Kliknij przycisk Create repository (Utwórz repozytorium).
  3. Po kilku chwilach repozytorium zostanie utworzone, a kod wygenerowany wcześniej w tym przewodniku Szybki start zostanie wypchnięty do nowego repozytorium. Wybierz przycisk Zobacz repozytorium , aby przejść do nowego repozytorium.
  4. Aby ponownie otworzyć i kontynuować edytowanie kodu, wybierz zieloną opcję rozwijaną „Kod” <>, przejdź do karty Codespaces i wybierz nazwę Codespace, nad którą wcześniej pracowałeś. Wróć do środowiska deweloperskiego Visual Studio Code Codespace.
  5. Użyj okienka Kontrola źródła, aby utworzyć nowe gałęzie i przygotować nowe zmiany w kodzie.

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.
  • Przejdź do strony przestrzeni kodu na swoim koncie GitHub, znajdź przestrzeń kodu utworzoną podczas tego szybkiego startu, wybierz wielokropek po prawej stronie, a następnie wybierz opcję Delete z menu kontekstowego.
  • 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