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

  • Artykuł

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 usługi GitHub Codespaces i terminalu powłoki bash programu Visual Studio Code w trybie online. 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 w celu ponownego azd 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 na potrzeby tworzenia aplikacji internetowych w języku Python:

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. Poniższy przewodnik Szybki start może mieć wpływ 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

azd Wybierz szablon na podstawie platformy internetowej Python, platformy hostingu internetowego platformy Azure i platformy bazy danych Platformy 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.

    Template Struktura sieci Web Baza danych Platforma hostingu Nowa przestrzeń kodu
    azure-django-postgres-flexible-aca Django Serwer elastyczny PostgreSQL Azure Container Apps Nowa przestrzeń kodu
    azure-django-postgres-flexible-appservice Django Serwer elastyczny PostgreSQL Azure App Service Nowa przestrzeń kodu
    azure-django-cosmos-postgres-aca Django Cosmos DB (Adapter PostgreSQL) Azure Container Apps 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 Usługi Azure Container Apps PostgreSQL Azure Container Apps Nowa przestrzeń kodu

  1. Dla wygody ostatnia kolumna każdej tabeli zawiera link, który tworzy nowy obszar Codespace i inicjuje azd szablon na koncie usługi 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ń kodu", aby wyświetlić stronę "Konfigurowanie przestrzeni kodu".

  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 klucza tyldy ~ , aby otworzyć terminal. Ponadto domyślnie terminal powinien być terminalem powłoki Bash. Jeśli tak nie jest, przejdź do powłoki bash w prawym górnym obszarze okna terminalu.

  2. W terminalu powłoki 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 klawisza Enter w celu otwarcia nowej karty przeglądarki i wklejenia kodu w polu tekstowym
    • Wybieranie konta platformy Azure z listy
    • Potwierdzanie, że próbujesz zalogować się do interfejsu wiersza polecenia platformy Microsoft Azure

  4. Po pomyślnym wykonaniu następującego komunikatu zostanie wyświetlony z powrotem 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 zostanie wyświetlony monit 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 udzieleniu odpowiedzi na te pytania dane wyjściowe z azd polecenia wskazują postęp wdrażania.

    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 polecenia azd down , aby usunąć wszystkie usługi utworzone przez azd upusługę .

    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.

    azd up Wykonanie może potrwać kilka minut, ponieważ aprowizacja i wdrażanie wielu usług platformy 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. Po azd up pomyślnym zakończeniu zostaną wyświetlone podobne dane wyjściowe:

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

Czyszczenie zasobów

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. W dolnej części zobaczysz listę ostatnich obszarów 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 środowisko Codespace, które jest kontenerem hostowanym przez usługę GitHub, w którym uruchomiono środowisko programistyczne programu Visual Studio Code z nowym kodem wygenerowanym azd na podstawie szablonu. 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 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ą listę rozwijaną "Kod"<> , przejdź do karty Codespaces i wybierz nazwę wcześniej działającej przestrzeni kodu. 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 podczas programu występują błędy 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.
  • Przejdź do strony Codespaces dla konta usługi GitHub, znajdź pozycję Codespace utworzoną podczas tego przewodnika Szybki start, wybierz wielokropek po prawej stronie i wybierz pozycję "Usuń" z menu kontekstowego.
  • W witrynie Azure Portal wyszukaj pozycję Magazyny kluczy. Wybierz pozycję Zarządzaj usuniętymi magazynami, wybierz subskrypcję, wybierz wszystkie magazyny kluczy zawierające nazwę azdtest lub dowolną nazwę środowiska, a następnie wybierz pozycję Przeczyść.
  • 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ść