Szybki start: wdrażanie aplikacji webowych w Pythonie (Django, Flask lub FastAPI) w Azure App Service

mkdir flask-quickstart
cd flask-quickstart
azd init --template https://github.com/Azure-Samples/msdocs-python-flask-webapp-quickstart
azd up

mkdir django-quickstart
cd django-quickstart
azd init --template https://github.com/Azure-Samples/msdocs-python-django-webapp-quickstart
azd up

mkdir fastapi-quickstart
cd fastapi-quickstart
azd init --template https://github.com/Azure-Samples/msdocs-python-fastapi-webapp-quickstart
azd up

git clone https://github.com/Azure-Samples/msdocs-python-flask-webapp-quickstart

git clone https://github.com/Azure-Samples/msdocs-python-django-webapp-quickstart

git clone https://github.com/Azure-Samples/msdocs-python-fastapi-webapp-quickstart.git

1. Przejdź do folderu aplikacji:

   cd msdocs-python-flask-webapp-quickstart
   

2. Utwórz środowisko wirtualne dla aplikacji:

   • Windows
   • macOS/Linux

   py -m venv .venv
   .venv\scripts\activate
   

3. Zainstaluj zależności:

   pip install -r requirements.txt
   

4. Uruchom aplikację:

   flask run
   

5. Przejdź do przykładowej aplikacji w http://localhost:5000 przeglądarce internetowej.

   

Masz problemy? Daj nam znać.

1. Przejdź do folderu aplikacji:

   cd msdocs-python-django-webapp-quickstart
   

2. Utwórz środowisko wirtualne dla aplikacji:

   • Windows
   • macOS/Linux

   py -m venv .venv
   .venv\scripts\activate
   

3. Zainstaluj zależności:

   pip install -r requirements.txt
   

4. Uruchom aplikację:

   python manage.py runserver
   

5. Przejdź do przykładowej aplikacji w http://localhost:8000 przeglądarce internetowej.

   

Masz problemy? Daj nam znać.

1. Przejdź do folderu aplikacji:

   cd msdocs-python-fastapi-webapp-quickstart
   

2. Utwórz środowisko wirtualne dla aplikacji:

   • Windows
   • macOS/Linux

   py -m venv .venv
   .venv\scripts\activate
   

3. Zainstaluj zależności:

   pip install -r requirements.txt
   

4. Uruchom aplikację:

   uvicorn main:app --reload
   

5. Przejdź do przykładowej aplikacji w http://localhost:8000 przeglądarce internetowej.

   

Masz problemy? Daj nam znać.

Polecenia Azure CLI można uruchamiać na komputerze z zainstalowanym Azure CLI.

Stwórz zasoby Azure, a następnie wdroż aplikację, używając oddzielnych poleceń Azure CLI.

W razie potrzeby zaloguj się do platformy Azure przy użyciu polecenia az login.

az login

Zastąp <app-name> globalnie unikalną nazwą. Stwórz grupę zasobów i plan App Service, a następnie stwórz aplikację webową za pomocą az webapp create.

az group create --name myResourceGroup --location eastus
az appservice plan create --name myAppServicePlan --resource-group myResourceGroup --sku P0v3 --is-linux
az webapp create --name <app-name> --resource-group myResourceGroup --plan myAppServicePlan --runtime "PYTHON:3.14"
az webapp config appsettings set --name <app-name> --resource-group myResourceGroup --settings SCM_DO_BUILD_DURING_DEPLOYMENT=true

• Użyj parametru --runtime, aby określić wersję Python, na której działa twoja aplikacja. Ten przykład wykorzystuje Python 3.14. Aby wypisać obsługiwane runtime'y Python, użyj az webapp list-runtimes --os-type linux --runtime python --output table.
• Użyj parametru, --sku aby zdefiniować rozmiar (CPU i pamięć) oraz koszt planu App Service. Ten przykład wykorzystuje plan usług P0v3 (Premium v3), który wiąże się z kosztem subskrypcji Azure. Aby uzyskać pełną listę planów usługi App Service, zobacz Cennik usługi App Service.
• Zamień eastus na preferowany region. Aby wyświetlić dostępne regiony, uruchom az account list-locations z --output table.
• Ustawienie SCM_DO_BUILD_DURING_DEPLOYMENT umożliwia budowę Oryxa, w tym instalację zależności w requirements.txt, gdy wdrażasz archiwum źródłowe.

Utwórz plik ZIP z plikami aplikacji, w tym requirements.txt, w katalogu głównym archiwum. Wyklucz lokalne pliki takie jak .venv, .git i .env. Instrukcje specyficzne dla platformy znajdziesz na karcie Wdrażanie przy użyciu pliku ZIP w sekcji Utworzenie pliku ZIP swojej aplikacji. Następnie wdroż archiwum za pomocą polecenia az webapp deploy:

az webapp deploy --name <app-name> --resource-group myResourceGroup --src-path <zip-file-path> --type zip

Wdrożenie może zająć kilka minut. Przejdź do https://<app-name>.azurewebsites.net, aby zobaczyć swoją aplikację. Aby streamować logi, włącz je, uruchamiając az webapp log config --name <app-name> --resource-group myResourceGroup --docker-container-logging filesystem, a następnie uruchom az webapp log tail --name <app-name> --resource-group myResourceGroup.

Aby utworzyć zasoby platformy Azure w programie VS Code, musisz mieć zainstalowany pakiet rozszerzenia Azure Tools i zalogować się do platformy Azure z poziomu programu VS Code.

W folderze aplikacji otwórz program VS Code:

code .

Instrukcje	Zrzut ekranu
Znajdź ikonę platformy Azure na pasku narzędzi po lewej stronie. Wybierz go, aby wyświetlić rozszerzenie Azure Tools for VS Code. Jeśli nie widzisz ikony Narzędzia platformy Azure, upewnij się, że masz zainstalowane rozszerzenie Narzędzia platformy Azure dla programu VS Code.
W rozszerzeniu Azure Tools dla programu VS Code: Znajdź sekcję ZASOBY i wybierz swoją subskrypcję. Wybierz + pozycję (Utwórz zasób...)
Wybierz opcję Create App Service Web App....
Wprowadź nazwę msdocs-python-webapp-quickstart-XYZ dla tej aplikacji internetowej, przy czym XYZ to dowolne trzy unikalne litery. Po wdrożeniu ta nazwa jest używana jako nazwa aplikacji.
Wybierz platformę uruchomieniową dla aplikacji. W tym przykładzie wybierz pozycję Python 3.14.
Wybierz plan usługi App Service (warstwa cenowa) dla tej aplikacji internetowej. Plan usługi App Service określa, ile zasobów (procesora CPU/pamięci) jest dostępnych dla aplikacji i ile płacisz. W tym przykładzie wybierz warstwę cenową Podstawowa (B1). Ten plan spowoduje naliczenie niewielkiej opłaty za subskrypcję platformy Azure, ale jest zalecany w celu uzyskania lepszej wydajności w warstwie Bezpłatna (F1).
Wybierz przycisk Wdróż w powiadomieniu "Utworzono nową aplikację internetową".
Wybierz folder Szybki start, w którym pracujesz jako folder do wdrożenia.
Odpowiedz tak , aby zaktualizować konfigurację kompilacji i zwiększyć wydajność wdrażania.
Po zakończeniu wdrażania w prawym dolnym rogu programu VS Code zostanie wyświetlone powiadomienie. To powiadomienie służy do przeglądania aplikacji internetowej.

Zaloguj się na portal Azure i wykonaj następujące kroki, aby utworzyć zasoby usługi App Service platformy Azure.

Instrukcje	Zrzut ekranu
W witrynie Azure Portal: Wprowadź usługi aplikacji na pasku wyszukiwania w górnej części portalu Azure. Wybierz element oznaczony etykietą App Services pod nagłówkiem Usługi w menu, które jest wyświetlane poniżej paska wyszukiwania.
Na stronie App Services wybierz pozycję + Utwórz, a następnie wybierz pozycję + Aplikacja internetowa z menu rozwijanego.
Na stronie Tworzenie aplikacji internetowej wypełnij formularz w następujący sposób. Grupa zasobów → wybierz pozycję Utwórz nową i użyj nazwy msdocs-python-webapp-quickstart. Nazwa → msdocs-python-webapp-quickstart-XYZ, gdzie XYZ jest dowolnymi trzema losowymi znakami. Ta nazwa musi być unikatowa w obrębie całej platformy Azure. Stos środowiska uruchomieniowego → python 3.14. Region → dowolny region świadczenia usługi Azure w pobliżu. Plan usługi App Service → w obszarze Plan cenowy wybierz pozycję Eksploruj plany cenowe, aby wybrać inny plan usługi App Service.
Plan usługi App Service określa ilość zasobów (procesora CPU/pamięci), które są dostępne dla aplikacji i koszt tych zasobów. W tym przykładzie w obszarze Tworzenie i testowanie wybierz plan Podstawowy B1 . Podstawowy plan B1 będzie obciążał Twoje konto platformy Azure niewielką opłatą, ale jest zalecany dla lepszej wydajności w porównaniu z darmowym planem F1. Po zakończeniu wybierz pozycję Wybierz , aby zastosować zmiany.
Na stronie głównej Tworzenie aplikacji internetowej wybierz pozycję Przejrzyj i utwórz w dolnej części ekranu. Spowoduje to przejście do strony Recenzja. Wybierz pozycję Utwórz , aby utworzyć usługę App Service.

Polecenia Azure CLI w poprzednim kroku utworzyły zasoby i wdrożyły Twoją aplikację. Możesz przejść do kolejnego kroku.

Ponieważ w poprzednim kroku utworzono niezbędne zasoby i wdrożono aplikację w jednym kroku, możesz przejść do następnego kroku.

Aplikacje można wdrażać na platformie Azure, tworząc i przekazując plik ZIP kodu aplikacji na platformę Azure. Pliki ZIP można przekazać na platformę Azure przy użyciu interfejsu wiersza polecenia platformy Azure lub klienta HTTP, takiego jak cURL.

Włączanie automatyzacji kompilacji

Podczas wdrażania pliku ZIP kodu w języku Python należy ustawić flagę, aby włączyć automatyzację kompilacji platformy Azure. Automatyzacja kompilacji zainstaluje wszelkie niezbędne wymagania i spakuje aplikację do uruchomienia na platformie Azure.

Automatyzacja budowania na platformie Azure jest włączana poprzez konfigurację ustawienia SCM_DO_BUILD_DURING_DEPLOYMENT w portalu Azure lub interfejsie wiersza poleceń platformy Azure.

• Portal Azure
• Azure CLI

Instrukcje	Zrzut ekranu
Na stronie aplikacji internetowej w witrynie Azure Portal: Wybierz pozycję Konfiguracja w nagłówku Ustawienia na pasku narzędzi po lewej stronie, aby wyświetlić ustawienia aplikacji. W obszarze Ustawienia aplikacji wybierz pozycję Nowe ustawienie aplikacji.
Za pomocą okna dialogowego wprowadź nowe ustawienie za pomocą: Nazwa → SCM_DO_BUILD_DURING_DEPLOYMENT Wartość → true
Wybierz pozycję Zapisz , aby zapisać ustawienia.

Tworzenie pliku ZIP aplikacji

Następnie utwórz plik ZIP aplikacji. Wystarczy dołączyć tylko składniki samej aplikacji. Nie trzeba uwzględniać żadnych plików ani katalogów rozpoczynających się kropką (.), taką jak .venv, .gitignore, .githublub .vscode.

zip -r <file-name>.zip . -x '.??*'

Przekazywanie pliku ZIP na platformę Azure

Po utworzeniu pliku ZIP plik można przekazać na platformę Azure przy użyciu interfejsu wiersza polecenia platformy Azure lub klienta HTTP, takiego jak cURL.

# Change these values to the ones used to create the App Service.
RESOURCE_GROUP_NAME='msdocs-python-webapp-quickstart'
APP_SERVICE_NAME='msdocs-python-webapp-quickstart-123'

az webapp deploy \
    --name $APP_SERVICE_NAME \
    --resource-group $RESOURCE_GROUP_NAME \
    --src-path <zip-file-path>

# Change these values to the ones used to create the App Service.
$resourceGroupName='msdocs-python-webapp-quickstart'
$appServiceName='msdocs-python-webapp-quickstart-123'

az webapp deploy `
    --name $appServiceName `
    --resource-group $resourceGroupName `
    --src-path <zip-file-path>

curl -X POST \
    -H 'Content-Type: application/zip' \
    -u '<deployment-user>' \
    -T <zip-file-name> \
    <URL>

curl -X POST `
    -H 'Content-Type: application/zip' `
    -u '<deployment-user>' `
    -T <zip-file-name> `
    <URL>

Usługa App Service automatycznie wykrywa obecność aplikacji Flask. Nie jest potrzebna żadna dodatkowa konfiguracja dla tego przewodnika szybkiego startu.

Usługa App Service automatycznie wykrywa obecność aplikacji Django. Nie jest potrzebna żadna dodatkowa konfiguracja dla tego przewodnika szybkiego startu.

Jeśli używasz Python 3.14 lub nowszy, App Service automatycznie wykrywa i uruchamia twoją aplikację FastAPI. Nie jest potrzebna dodatkowa konfiguracja do tego szybkiego startu.

Jeśli używasz Python 3.13 lub starszego, musisz skonfigurować niestandardowe polecenie startowe App Service, aby uruchomiła Twoją aplikację. Następujące polecenie uruchamia Gunicorn z dwoma procesami roboczymi Uvicorn: gunicorn -w 2 -k uvicorn.workers.UvicornWorker -b 0.0.0.0:8000 main:app.

Najpierw skonfiguruj polecenie uruchamiania przy użyciu az webapp config set.

az webapp config set \
    --startup-file "gunicorn -w 2 -k uvicorn.workers.UvicornWorker -b 0.0.0.0:8000 main:app" \
    --name $APP_SERVICE_NAME \
    --resource-group $RESOURCE_GROUP_NAME

Następnie uruchom ponownie aplikację internetową przy użyciu polecenia az webapp restart .

az webapp restart \
    --name $APP_SERVICE_NAME \
    --resource-group $RESOURCE_GROUP_NAME

Usługa App Service automatycznie wykrywa obecność aplikacji Flask. Nie jest potrzebna żadna dodatkowa konfiguracja dla tego przewodnika szybkiego startu.

Usługa App Service automatycznie wykrywa obecność aplikacji Django. Nie jest potrzebna żadna dodatkowa konfiguracja dla tego przewodnika szybkiego startu.

Jeśli używasz Python 3.13 lub starszego, użyj Azure CLI lub portalu Azure do skonfigurowania polecenia startowego.

Usługa App Service automatycznie wykrywa obecność aplikacji Flask. Nie jest potrzebna żadna dodatkowa konfiguracja dla tego przewodnika szybkiego startu.

Usługa App Service automatycznie wykrywa obecność aplikacji Django. Nie jest potrzebna żadna dodatkowa konfiguracja dla tego przewodnika szybkiego startu.

Jeśli używasz Python 3.14 lub nowszy, App Service automatycznie wykrywa i uruchamia twoją aplikację FastAPI. Nie potrzebujesz żadnej dodatkowej konfiguracji do tego szybkiego startu.

Jeśli używasz Python 3.13 lub starszego, musisz skonfigurować niestandardowe polecenie startowe App Service, aby uruchomiła Twoją aplikację. Następujące polecenie uruchamia Gunicorn z dwoma procesami roboczymi Uvicorn: gunicorn -w 2 -k uvicorn.workers.UvicornWorker -b 0.0.0.0:8000 main:app.

Instrukcje	Zrzut ekranu
Jeśli używasz Python 3.13 lub starszego, skonfiguruj polecenie startowe w Azure App Service. Przejdź do instancji App Service w portalu Azure. Wybierz pozycję Konfiguracja w obszarze nagłówka Ustawienia w menu po lewej stronie. Upewnij się, że wybrano kartę Ustawienia ogólne. W polu Polecenie startowe wprowadź gunicorn -w 2 -k uvicorn.workers.UvicornWorker -b 0.0.0.0:8000 main:app. Wybierz Zapisz, aby zapisać zmiany. Przed kontynuowaniem poczekaj na powiadomienie, że ustawienia zostaną zaktualizowane. Jeśli używasz Python 3.14 lub nowszy, nie jest wymagane żadne polecenie startowe.
Następnie uruchom ponownie aplikację internetową. Wybierz pozycję Przegląd w menu po lewej stronie. W górnym menu wybierz pozycję Uruchom ponownie.

@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'))

def index(request):
    print('Request for index page received')
    return render(request, 'hello_azure/index.html')

@csrf_exempt
def hello(request):
    if request.method == 'POST':
        name = request.POST.get('name')
        
        if name is None or name == '':
            print("Request for hello page received with no name or blank name -- redirecting")
            return redirect('index')
        else:
            print("Request for hello page received with name=%s" % name)
            context = {'name': name }
            return render(request, 'hello_azure/hello.html', context)
    else:

@app.get("/", response_class=HTMLResponse)
async def index(request: Request):
    print('Request for index page received')
    return templates.TemplateResponse('index.html', {"request": request})

@app.get('/favicon.ico')
async def favicon():
    file_name = 'favicon.ico'
    file_path = './static/' + file_name
    return FileResponse(path=file_path, headers={'mimetype': 'image/vnd.microsoft.icon'})

@app.post('/hello', response_class=HTMLResponse)
async def hello(request: Request, name: str = Form(...)):
    if name:
        print('Request for hello page received with name=%s' % name)
        return templates.TemplateResponse('hello.html', {"request": request, 'name':name})
    else:
        print('Request for hello page received with no name or blank name -- redirecting')
        return RedirectResponse(request.url_for("index"), status_code=status.HTTP_302_FOUND)

Najpierw należy skonfigurować Azure App Service, aby wyprowadzać dzienniki do systemu plików 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

az webapp log config `
    --web-server-logging 'filesystem' `
    --name $APP_SERVICE_NAME `
    --resource-group $RESOURCE_GROUP_NAME

Aby streamować dzienniki, użyj polecenia az webapp log tail.

az webapp log tail \
    --name $APP_SERVICE_NAME \
    --resource-group $RESOURCE_GROUP_NAME

az webapp log tail `
    --name $APP_SERVICE_NAME `
    --resource-group $RESOURCE_GROUP_NAME

Odśwież stronę główną w aplikacji lub spróbuj wykonać inne żądania, aby spowodować wygenerowanie komunikatów 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"

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.

Wykonaj następujące kroki podczas logowania do witryny Azure Portal, aby usunąć grupę zasobów.

Instrukcje	Zrzut ekranu
Przejdź do grupy zasobów w witrynie Azure Portal. Wprowadź nazwę grupy zasobów na pasku wyszukiwania w górnej części strony. W obszarze nagłówka Grupy zasobów wybierz nazwę grupy zasobów, aby przejść do niej.
Wybierz przycisk Usuń grupę zasobów w górnej części strony.
W oknie dialogowym potwierdzenia wprowadź nazwę grupy zasobów, aby potwierdzić usunięcie. Wybierz pozycję Usuń , aby usunąć grupę zasobów.