Udostępnij za pośrednictwem

Szybki start: tworzenie i wdrażanie aplikacji internetowej w języku Python z usługi GitHub Codespaces na platformie Azure przy użyciu szablonu interfejsu wiersza polecenia dla deweloperów platformy Azure

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:

  • Wybierz szablon interfejsu wiersza polecenia dla deweloperów platformy Azure (azd) oparty na strukturze internetowej języka Python, platformie Azure database i platformie hostingu internetowego platformy Azure, na której chcesz budować.
  • Utwórz nową usługę GitHub Codespace zawierającą kod wygenerowany na podstawie wybranego azd szablonu.
  • Użyj GitHub Codespaces i online terminalu bash w Visual Studio Code. Terminal umożliwia uruchamianie szablonu w celu utworzenia azd przykładowej aplikacji internetowej i bazy danych przy użyciu poleceń interfejsu wiersza polecenia platformy Azure oraz utworzenia i skonfigurowania niezbędnych zasobów platformy Azure, a następnie wdrożenia przykładowej aplikacji internetowej na platformie Azure.
  • Edytuj aplikację internetową w usłudze GitHub Codespace i użyj polecenia azd do ponownego wdrożenia.
  • azd Użyj polecenia , aby wyczyścić zasoby platformy Azure.
  • Zamknij i otwórz ponownie usługę 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 azd szablonach do tworzenia aplikacji internetowych w Pythonie:

Wymagania wstępne

Ważne

Zarówno usługi 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 zostały utworzone przy użyciu najmniej kosztownej warstwy opcji, ale niektóre mogą nie być bezpłatne. Skorzystaj z kalkulatora cen platformy Azure , aby lepiej zrozumieć koszty. Aby uzyskać więcej informacji, zobacz Cennik usługi GitHub Codespaces , aby uzyskać więcej informacji.

Wybieranie szablonu i tworzenie przestrzeni kodu

Wybierz szablon w oparciu o framework internetowy Python, platformę hostingu sieciowego Azure i platformę baz danych Azure, 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 (aplikacje kontenerowe Azure) Nowa przestrzeń kodu
    azure-django-postgres-elastyczna-usługa-aplikacji Django Serwer elastyczny PostgreSQL Azure App Service Nowa przestrzeń kodu
    azure-django-cosmos-postgres-aca Django Cosmos DB (Adapter PostgreSQL) Azure Container Apps (aplikacje kontenerowe Azure) Nowa przestrzeń kodu
    azure-django-cosmos-postgres-appservice Django Cosmos DB (Adapter PostgreSQL) Azure App Service Nowa przestrzeń kodu
    azure-django-postgres-addon-aca Django Dodatek PostgreSQL dla Azure Container Apps Azure Container Apps (aplikacje kontenerowe Azure) Nowa przestrzeń kodu

  1. Dla Twojej wygody, ostatnia kolumna każdej tabeli zawiera link, który tworzy nowy obszar roboczy Codespace i inicjuje azd szablon na Twoim koncie GitHub. Kliknij prawym przyciskiem myszy i wybierz pozycję "Otwórz w nowej karcie" w linku "New Codespace" obok nazwy szablonu wybranego w celu zainicjowania procesu instalacji.

    Podczas tego procesu może zostać wyświetlony monit o zalogowanie się do konta usługi GitHub i zostanie wyświetlony monit o potwierdzenie, że chcesz utworzyć aplikację Codespace. Wybierz przycisk "Utwórz przestrzeń roboczą", aby wyświetlić podstronę "Konfigurowanie przestrzeni roboczej".

  2. Po kilku minutach w nowej karcie przeglądarki zostanie załadowana internetowa wersja programu Visual Studio Code z szablonem internetowym języka Python załadowanym jako obszar roboczy w widoku Eksploratora.

Uwierzytelnianie na platformie Azure i wdrażanie szablonu azd

Teraz, gdy masz już usługę GitHub Codespace zawierającą nowo wygenerowany kod, użyjesz azd narzędzia z poziomu usługi Codespace, aby opublikować kod na platformie Azure.

  1. W internetowym programie Visual Studio Code terminal powinien być domyślnie otwarty. Jeśli tak nie jest, użyj klawisza tyldy ~ aby otworzyć terminal. Ponadto domyślnie terminal powinien być terminalem 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 proces uwierzytelniania usługi Codespace na koncie platformy 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 Enter w celu otwarcia nowej karty przeglądarki i wklejenia kodu w polu tekstowym
    • Wybieranie konta platformy Azure z listy
    • Potwierdzenie, że próbujesz się zalogować do 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ę na platformie Azure, wprowadzając następujące polecenie:

    azd up

    Podczas tego procesu zostaniesz poproszony o:

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

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

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

    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, 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. Przed rozwiązaniem problemu poczekaj 5–10 minut, aby sprawdzić, czy problem zostanie rozwiązany.

    Ctrl + kliknij pierwszy adres URL po słowie - Endpoint: , aby wyświetlić przykładowy projekt aplikacji internetowej uruchomiony na platformie Azure.

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

Edytowanie i ponowne wdrażanie

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

  1. Wróć do karty przeglądarki zawierającej program Visual Studio Code i użyj widoku Eksplorator programu Visual Studio Code, aby przejść do folderu src/templates i otworzyć 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 platformy Azure i przepływ pracy funkcji 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 usłudze Codespace. Jeśli planujesz kontynuować pracę nad kodem, należy opublikować 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ę i przejdź do: https://github.com/codespaces

  3. Na dole zobaczysz spis ostatnich Codespaces. Poszukaj elementu utworzonego w sekcji zatytułowanej "Własnością usługi 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 usługi Codespaces

Na tym etapie masz Codespace, która jest kontenerem hostowanym przez GitHub, w którym działa Twoje środowisko programistyczne 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, należy ustawić ten priorytet.

  1. W menu kontekstowym 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. Wybierz pozycję "Utwórz repozytorium".
  3. Po krótkiej chwili repozytorium zostanie utworzone, a kod wygenerowany wcześniej w przewodniku szybkiego startu zostanie przesłany do nowego repozytorium. Wybierz przycisk "Zobacz repozytorium", aby przejść do nowego repozytorium.
  4. Aby ponownie otworzyć i kontynuować edytowanie kodu, wybierz zieloną listę rozwijaną "<> Kod", przejdź do karty Codespaces i wybierz nazwę obszaru kodu, nad którym wcześniej pracowałeś. Teraz powinno nastąpić powrót do środowiska programistycznego Codespace Visual Studio Code.
  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 w trakcie działania programu pojawią się błędy azd up, wypróbuj następujące kroki:

  • 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.
  • Przejdź do strony Codespaces dla twojego konta GitHub, znajdź Codespace utworzoną podczas tego szybkiego startu, wybierz wielokropek po prawej stronie i wybierz "Usuń" z menu kontekstowego.
  • 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ń.

Treści powiązane