Szybki start: wdrażanie aplikacji internetowej w języku Python (Django lub Flask) w usłudze aplikacja systemu Azure Service
Uwaga
Od 1 czerwca 2024 r. wszystkie nowo utworzone aplikacje usługi App Service będą miały możliwość utworzenia unikatowej domyślnej nazwy hosta z konwencją <app-name>
<region>
-<random-hash>
nazewnictwa ...azurewebsites.net
Nazwy istniejących aplikacji nie zostaną zmienione.
Przykład: myapp-ds27dh7271aah175.westus-01.azurewebsites.net
Aby uzyskać więcej informacji, zobacz Unikatowa domyślna nazwa hosta zasobu usługi App Service.
W tym przewodniku Szybki start wdrożysz aplikację internetową języka Python (Django lub Flask) w usłudze aplikacja systemu Azure Service. aplikacja systemu Azure Service to w pełni zarządzana usługa hostingu sieci Web, która obsługuje aplikacje języka Python hostowane w środowisku serwera z systemem Linux.
Aby ukończyć ten przewodnik Szybki Start, musisz spełnić następujące warunki:
- Konto platformy Azure z aktywną subskrypcją. Utwórz konto bezpłatnie.
- Zainstalowany lokalnie język Python w wersji 3.9 lub nowszej .
Uwaga
Ten artykuł zawiera bieżące instrukcje dotyczące wdrażania aplikacji internetowej w języku Python przy użyciu usługi aplikacja systemu Azure Service. Język Python w systemie Windows nie jest już obsługiwany.
1 — Przykładowa aplikacja
Ten przewodnik Szybki start można ukończyć przy użyciu platformy Flask lub Django. Udostępniono przykładową aplikację w każdej strukturze, która pomoże Ci wykonać czynności opisane w tym przewodniku Szybki start. Pobierz lub sklonuj przykładową aplikację na lokalną stację roboczą.
Aby uruchomić aplikację lokalnie:
Przejdź do folderu aplikacji:
cd msdocs-python-flask-webapp-quickstart
Utwórz środowisko wirtualne dla aplikacji:
py -m venv .venv .venv\scripts\activate
Zainstaluj zależności:
pip install -r requirements.txt
Uruchom aplikację:
flask run
Przejdź do przykładowej aplikacji w
http://localhost:5000
przeglądarce internetowej.
Masz problemy? Daj nam znać.
2 — Tworzenie aplikacji internetowej na platformie Azure
Aby hostować aplikację na platformie Azure, musisz utworzyć aplikację internetową usługi aplikacja systemu Azure Service na platformie Azure. Aplikację internetową można utworzyć przy użyciu interfejsu wiersza polecenia platformy Azure, programu VS Code, pakietu rozszerzeń narzędzi platformy Azure lub witryny Azure Portal.
Polecenia interfejsu wiersza polecenia platformy Azure można uruchamiać na komputerze z zainstalowanym interfejsem wiersza polecenia platformy Azure.
Interfejs wiersza polecenia platformy Azure zawiera polecenie az webapp up
, które spowoduje utworzenie niezbędnych zasobów i wdrożenie aplikacji w jednym kroku.
W razie potrzeby zaloguj się do platformy Azure przy użyciu polecenia az login.
az login
Utwórz aplikację internetową i inne zasoby, a następnie wdróż kod na platformie Azure przy użyciu polecenia az webapp up.
az webapp up --runtime PYTHON:3.9 --sku B1 --logs
- Parametr
--runtime
określa, jaka wersja języka Python jest uruchomiona. W tym przykładzie użyto języka Python 3.9. Aby wyświetlić listę wszystkich dostępnych środowisk uruchomieniowych, użyj poleceniaaz webapp list-runtimes --os linux --output table
. - Parametr
--sku
definiuje rozmiar (procesor, pamięć) i koszt planu usługi App Service. W tym przykładzie użyto planu usługi B1 (wersja podstawowa), który spowoduje niewielkie koszty w ramach subskrypcji platformy Azure. Aby uzyskać pełną listę planów usługi App Service, wyświetl stronę cennika usługi App Service. - Flaga
--logs
konfiguruje domyślne rejestrowanie wymagane do włączenia wyświetlania strumienia dziennika natychmiast po uruchomieniu aplikacji internetowej. - Opcjonalnie możesz określić nazwę z argumentem
--name <app-name>
. Jeśli go nie podasz, zostanie automatycznie wygenerowana nazwa. - Opcjonalnie możesz dołączyć argument
--location <location-name>
, w którym<location_name>
jest dostępny region platformy Azure. Listę dozwolonych regionów dla konta platformy Azure można pobrać, uruchamiającaz account list-locations
polecenie .
Wykonanie polecenia może potrwać kilka minut. Gdy polecenie jest uruchomione, udostępnia komunikaty o tworzeniu grupy zasobów, planie usługi App Service i zasobie aplikacji, konfigurowaniu rejestrowania i wdrażaniu pliku ZIP. Następnie zostanie wyświetlony komunikat "Możesz uruchomić aplikację pod adresem http://< app-name.azurewebsites.net>", który jest adresem URL aplikacji na platformie Azure.
The webapp '<app-name>' doesn't exist Creating Resource group '<group-name>' ... Resource group creation complete Creating AppServicePlan '<app-service-plan-name>' ... Creating webapp '<app-name>' ... Configuring default logging for the app, if not already enabled Creating zip with contents of dir /home/cephas/myExpressApp ... Getting scm site credentials for zip deployment Starting zip deployment. This operation can take a while to complete ... Deployment endpoint responded with status code 202 You can launch the app at http://<app-name>.azurewebsites.net { "URL": "http://<app-name>.azurewebsites.net", "appserviceplan": "<app-service-plan-name>", "location": "centralus", "name": "<app-name>", "os": "<os-type>", "resourcegroup": "<group-name>", "runtime_version": "python|3.9", "runtime_version_detected": "0.0", "sku": "FREE", "src_path": "<your-folder-location>" }
Uwaga
Polecenie az webapp up
wykonuje następujące akcje:
Utwórz domyślną grupę zasobów.
Utwórz domyślny plan usługi App Service.
Utwórz aplikację o określonej nazwie.
Zip wdróż wszystkie pliki z bieżącego katalogu roboczego z włączoną automatyzacją kompilacji.
Buforuj parametry lokalnie w pliku .azure/config , aby nie trzeba było ich ponownie określać podczas wdrażania później za pomocą
az webapp up
polecenia lub innychaz webapp
poleceń z folderu projektu. Buforowane wartości są domyślnie używane automatycznie.
Masz problemy? Daj nam znać.
3 — Wdrażanie kodu aplikacji na platformie Azure
usługa aplikacja systemu Azure obsługuje wiele metod wdrażania kodu aplikacji na platformie Azure, w tym obsługę funkcji GitHub Actions i wszystkich głównych narzędzi ciągłej integracji/ciągłego wdrażania. W tym artykule opisano sposób wdrażania kodu z lokalnej stacji roboczej na platformie Azure.
- Wdrażanie przy użyciu interfejsu wiersza polecenia platformy Azure
- Wdrażanie przy użyciu programu VS Code
- Wdrażanie przy użyciu lokalnego narzędzia Git
- Wdrażanie przy użyciu pliku ZIP
az webapp up
Ponieważ polecenie utworzyło niezbędne zasoby i wdrożyło aplikację w jednym kroku, możesz przejść do 4 — przejdź do aplikacji.
Masz problemy? Najpierw zapoznaj się z przewodnikiem rozwiązywania problemów. W przeciwnym razie daj nam znać.
4 — Przechodzenie do aplikacji
Przejdź do wdrożonej aplikacji w przeglądarce internetowej pod adresem URL http://<app-name>.azurewebsites.net
. Jeśli zostanie wyświetlona domyślna strona aplikacji, zaczekaj minutę i odśwież przeglądarkę.
Przykładowy kod w języku Python uruchamia kontener systemu Linux w usłudze App Service przy użyciu wbudowanego obrazu.
Gratulacje! Aplikacja języka Python została wdrożona w usłudze App Service.
Masz problemy? Najpierw zapoznaj się z przewodnikiem rozwiązywania problemów. W przeciwnym razie daj nam znać.
5 — Przesyłanie strumieniowe dzienników
usługa aplikacja systemu Azure przechwytuje wszystkie komunikaty wyjściowe do konsoli, aby ułatwić diagnozowanie problemów z aplikacją. Przykładowe aplikacje zawierają print()
instrukcje, aby zademonstrować tę funkcję.
@app.route('/')
def index():
print('Request for index page received')
return render_template('index.html')
@app.route('/favicon.ico')
def favicon():
return send_from_directory(os.path.join(app.root_path, 'static'),
'favicon.ico', mimetype='image/vnd.microsoft.icon')
@app.route('/hello', methods=['POST'])
def hello():
name = request.form.get('name')
if name:
print('Request for hello page received with name=%s' % name)
return render_template('hello.html', name = name)
else:
print('Request for hello page received with no name or blank name -- redirecting')
return redirect(url_for('index'))
Zawartość dzienników diagnostycznych usługi App Service można przejrzeć przy użyciu interfejsu wiersza polecenia platformy Azure, programu VS Code lub witryny Azure Portal.
Najpierw należy skonfigurować usługę aplikacja systemu Azure w celu wyprowadzania dzienników do systemu plików usługi App Service przy użyciu polecenia az webapp log config.
az webapp log config \
--web-server-logging filesystem \
--name $APP_SERVICE_NAME \
--resource-group $RESOURCE_GROUP_NAME
Aby przesłać strumieniowo dzienniki, użyj polecenia az webapp log tail .
az webapp log tail \
--name $APP_SERVICE_NAME \
--resource-group $RESOURCE_GROUP_NAME
Odśwież stronę główną w aplikacji lub spróbuj wygenerować niektóre komunikaty dziennika. Dane wyjściowe powinny wyglądać podobnie do poniższych.
Starting Live Log Stream ---
2021-12-23T02:15:52.740703322Z Request for index page received
2021-12-23T02:15:52.740740222Z 169.254.130.1 - - [23/Dec/2021:02:15:52 +0000] "GET / HTTP/1.1" 200 1360 "https://msdocs-python-webapp-quickstart-123.azurewebsites.net/hello" "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:95.0) Gecko/20100101 Firefox/95.0"
2021-12-23T02:15:52.841043070Z 169.254.130.1 - - [23/Dec/2021:02:15:52 +0000] "GET /static/bootstrap/css/bootstrap.min.css HTTP/1.1" 200 0 "https://msdocs-python-webapp-quickstart-123.azurewebsites.net/" "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:95.0) Gecko/20100101 Firefox/95.0"
2021-12-23T02:15:52.884541951Z 169.254.130.1 - - [23/Dec/2021:02:15:52 +0000] "GET /static/images/azure-icon.svg HTTP/1.1" 200 0 "https://msdocs-python-webapp-quickstart-123.azurewebsites.net/" "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:95.0) Gecko/20100101 Firefox/95.0"
2021-12-23T02:15:53.043211176Z 169.254.130.1 - - [23/Dec/2021:02:15:53 +0000] "GET /favicon.ico HTTP/1.1" 404 232 "https://msdocs-python-webapp-quickstart-123.azurewebsites.net/" "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:95.0) Gecko/20100101 Firefox/95.0"
2021-12-23T02:16:01.304306845Z Request for hello page received with name=David
2021-12-23T02:16:01.304335945Z 169.254.130.1 - - [23/Dec/2021:02:16:01 +0000] "POST /hello HTTP/1.1" 200 695 "https://msdocs-python-webapp-quickstart-123.azurewebsites.net/" "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:95.0) Gecko/20100101 Firefox/95.0"
2021-12-23T02:16:01.398399251Z 169.254.130.1 - - [23/Dec/2021:02:16:01 +0000] "GET /static/bootstrap/css/bootstrap.min.css HTTP/1.1" 304 0 "https://msdocs-python-webapp-quickstart-123.azurewebsites.net/hello" "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:95.0) Gecko/20100101 Firefox/95.0"
2021-12-23T02:16:01.430740060Z 169.254.130.1 - - [23/Dec/2021:02:16:01 +0000] "GET /static/images/azure-icon.svg HTTP/1.1" 304 0 "https://msdocs-python-webapp-quickstart-123.azurewebsites.net/hello" "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:95.0) Gecko/20100101 Firefox/95.0"
Masz problemy? Najpierw zapoznaj się z przewodnikiem rozwiązywania problemów. W przeciwnym razie daj nam znać.
Czyszczenie zasobów
Po zakończeniu pracy z przykładową aplikacją możesz usunąć wszystkie zasoby aplikacji z platformy Azure. Nie będą naliczane dodatkowe opłaty i nie zostaną anulowane subskrypcje platformy Azure. Usunięcie grupy zasobów spowoduje również usunięcie wszystkich zasobów w grupie zasobów i jest najszybszym sposobem usunięcia wszystkich zasobów platformy Azure dla aplikacji.
Usuń grupę zasobów przy użyciu polecenia az group delete .
az group delete \
--name msdocs-python-webapp-quickstart \
--no-wait
--no-wait
Argument umożliwia zwracanie polecenia przed ukończeniem operacji.
Masz problemy? Daj nam znać.