빠른 시작: Azure App Service에 Python(Django, Flask 또는 FastAPI) 웹앱 배포

이 빠른 시작에서는 Python 웹앱(Django, Flask 또는 FastAPI)을 Azure App Service에 배포합니다. Azure App Service는 Linux 서버 환경에 호스트되는 Python 앱을 지원하는 완전 관리형 웹 호스팅 서비스입니다.

이 빠른 시작을 완료하려면 다음이 필요합니다.

활성 구독이 있는 Azure 계정. 체험 계정을 만듭니다.
Python 3.14 이상이 로컬로 설치되었습니다.

참고

이 문서에는 Azure App Service를 사용하여 Python 웹앱을 배포하는 방법에 대한 현재 지침이 포함되어 있습니다. Windows의 Python은 더 이상 지원되지 않습니다.

Azure Developer CLI를 사용하여 이 자습서에서 샘플 앱을 신속하게 배포하고 Azure에서 실행되는 것을 확인할 수 있습니다. Azure Cloud Shell에서 다음 명령을 실행하고 프롬프트를 따릅니다.

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

리소스를 삭제하려면 다음을 수행합니다.

azd down

샘플 애플리케이션

이 빠른 시작은 Flask, Django 또는 FastAPI를 사용하여 완료할 수 있습니다. 이 빠른 시작을 따라갈 수 있도록 각 프레임워크의 샘플 애플리케이션이 제공됩니다. 샘플 애플리케이션을 로컬 워크스테이션에 다운로드하거나 복제합니다.

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

로컬에서 애플리케이션을 실행하려면 다음을 수행합니다.

다음과 같이 애플리케이션 폴더로 이동합니다.
```
cd msdocs-python-flask-webapp-quickstart
```

앱에 대한 가상 환경을 만듭니다.

Windows
macOS/Linux

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

python3 -m venv .venv
source .venv/bin/activate

종속성을 설치합니다.
```
pip install -r requirements.txt
```
앱 실행:
```
flask run
```
웹 브라우저에서 http://localhost:5000에 있는 샘플 애플리케이션을 찾습니다.

문제가 있나요? 알려주세요.

다음과 같이 애플리케이션 폴더로 이동합니다.
```
cd msdocs-python-django-webapp-quickstart
```

앱에 대한 가상 환경을 만듭니다.

Windows
macOS/Linux

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

python3 -m venv .venv
source .venv/bin/activate

종속성을 설치합니다.
```
pip install -r requirements.txt
```
앱 실행:
```
python manage.py runserver
```
웹 브라우저에서 http://localhost:8000에 있는 샘플 애플리케이션을 찾습니다.

문제가 있나요? 알려주세요.

다음과 같이 애플리케이션 폴더로 이동합니다.
```
cd msdocs-python-fastapi-webapp-quickstart
```

앱에 대한 가상 환경을 만듭니다.

Windows
macOS/Linux

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

python3 -m venv .venv
source .venv/bin/activate

종속성을 설치합니다.
```
pip install -r requirements.txt
```
앱 실행:
```
uvicorn main:app --reload
```
웹 브라우저에서 http://localhost:8000에 있는 샘플 애플리케이션을 찾습니다.

문제가 있나요? 알려주세요.

Azure에서 웹앱 만들기

Azure에서 애플리케이션을 호스트하려면 Azure에서 Azure App Service 웹앱을 만들어야 합니다. Azure CLI, VS Code, Azure Tools 확장 팩 또는 Azure Portal을 사용하여 웹앱을 만들 수 있습니다.

Azure CLI 명령은 Azure CLI가 설치된 컴퓨터에서 실행할 수 있습니다.

Azure 리소스를 생성한 후, 별도의 Azure CLI 명령어로 애플리케이션을 배포하세요.

필요한 경우 az login을 사용하여 Azure에 로그인합니다.

az login

전 세계적으로 고유한 이름으로 교체하세요 <app-name> . 리소스 그룹과 앱 서비스 계획을 만들고, 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

--runtime 파라미터를 사용해 앱이 실행되는 Python 버전을 지정하세요. 이 예시는 Python 3.14를 사용합니다. 지원되는 Python 런타임을 나열하려면 az webapp list-runtimes --os-type linux --runtime python --output table을 사용하세요.
--sku 매개변수를 사용하여 앱 서비스 계획의 크기(CPU 및 메모리)와 비용을 정의하세요. 이 예시는 P0v3(프리미엄 v3) 서비스 플랜을 사용하며, 이는 Azure 구독에 비용이 발생합니다. App Service 계획의 전체 목록은 App Service 가격 책정을 참조하세요.
eastus을 원하는 지역으로 교체하세요. 사용 가능한 리전을 나열하려면 az account list-locations을(를) --output table와 함께 실행하세요.
이 설정을 사용하면 소스 아카이브를 배포할 때 requirements.txt의 종속성 설치를 포함한 Oryx 빌드가 활성화됩니다.

애플리케이션 파일(requirements.txt 포함)을 아카이브 루트에 두고 ZIP 파일을 생성합니다. .venv, .git, .env와 같은 로컬 파일은 제외하세요. 플랫폼별 지침은 Deploy using a ZIP file 탭의 Create a ZIP file of your application을 참조하세요. 그 다음 az webapp deploy를 사용하여 아카이브를 배포하세요:

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

배치는 몇 분 정도 걸릴 수 있습니다. 앱을 보려면 https://<app-name>.azurewebsites.net로 이동하여 확인하세요. 로그를 스트리밍하려면 az webapp log config --name <app-name> --resource-group myResourceGroup --docker-container-logging filesystem를 실행하여 활성화한 다음 az webapp log tail --name <app-name> --resource-group myResourceGroup를 실행하세요.

VS Code에서 Azure 리소스를 만들려면 Azure Tools 확장 팩을 설치하고 VS Code에서 Azure로 로그인해야 합니다.

Azure Tools 확장 팩 다운로드

애플리케이션 폴더에서 VS Code를 엽니다.

code .

지시	스크린샷
왼쪽 도구 모음에서 Azure 아이콘을 찾습니다. 아이콘을 선택하여 Azure Tools for VS Code 확장을 표시합니다. Azure Tools 아이콘이 보이지 않으면 VS Code용 Azure Tools 확장이 설치되어 있는지 확인합니다.
VS Code용 Azure Tools 확장에서 다음을 수행합니다. 리소스 섹션을 찾아 구독을 선택합니다. +(리소스 만들기...)를 선택합니다.
App Service 웹앱 만들기... 옵션을 선택합니다.
이 웹앱의 이름 msdocs-python-webapp-quickstart-XYZ를 입력합니다. XYZ는 고유한 3개 문자입니다. 배포할 때 이 이름은 앱 이름으로 사용됩니다.
애플리케이션에 대한 런타임 스택을 선택합니다. 이 예제에서는 Python 3.14를 선택합니다.
이 웹앱에 사용할 App Service 요금제(가격 책정 계층)를 선택합니다. App Service 요금제는 앱에서 사용할 수 있는 리소스 수(CPU/메모리)와 지불 금액을 제어합니다. 이 예제에서는 기본(B1) 가격 책정 계층을 선택합니다. 이 요금제는 Azure 구독 요금이 약간 발생하지만 무료(F1) 계층보다 좋은 성능을 제공하므로 이 요금제를 사용하는 것이 좋습니다.
"새 웹앱 만들기" 알림에서 배포 단추를 선택합니다.
작업 중인 빠른 시작 폴더를 배포할 폴더로 선택합니다.
예를 선택하여 빌드 구성을 업데이트하고 배포 성능을 향상시킵니다.
배포가 완료되면 VS Code의 오른쪽 아래 모서리에 알림이 나타납니다. 이 알림을 사용하여 웹앱으로 이동할 수 있습니다.

Azure Portal에 로그인하고 다음 단계에 따라 Azure App Service 리소스를 만듭니다.

지시	스크린샷
Azure Portal에서 다음을 수행합니다. Azure Portal 맨 위에 있는 검색 창에 앱 서비스를 입력합니다. 검색 창 아래에 표시되는 메뉴의 Services 제목 아래에서 App Services 레이블이 지정된 항목을 선택합니다.
App Services 페이지에서 + 만들기를 선택한 다음 드롭다운 메뉴에서 + 웹앱을 선택합니다.
웹앱 만들기 페이지에서 다음과 같이 양식을 작성합니다. 리소스 그룹 → 새로 만들기를 선택하고 이름으로 msdocs-python-webapp-quickstart를 사용합니다. 이름 → msdocs-python-webapp-quickstart-XYZ를 선택합니다. XYZ는 임의의 세 문자입니다. 이 이름은 Azure에서 고유해야 합니다. 런타임 스택 → Python 3.14 지역 → 가까운 Azure 지역을 선택합니다. App Service 요금제 → 가격 책정 요금제에서 가격 책정 요금제 탐색을 선택하여 다른 App Service 요금제를 선택합니다.
App Service 계획은 앱에서 사용할 수 있는 리소스 양(CPU/메모리)과 해당 리소스의 비용을 제어합니다. 이 예제의 경우 개발/테스트에서 B1 기본 요금제를 선택합니다. B1 기본 요금제는 Azure 계정에 요금을 소액 부과하지만 F1 무료 요금제보다 더 나은 성능을 발휘하려면 사용하는 것이 좋습니다. 완료되면 선택을 선택하여 변경 내용을 적용합니다.
기본 웹앱 만들기 페이지의 화면 아래쪽에서 검토 + 만들기를 선택합니다. 그러면 [검토] 페이지로 이동됩니다. 만들기를 선택하여 App Service를 만듭니다.

문제가 있나요? 알려주세요.

Azure에 애플리케이션 코드 배포

Azure App Service는 GitHub Actions 및 모든 주요 CI/CD 도구를 포함하여 애플리케이션 코드를 Azure에 배포하는 여러 메서드를 지원합니다. 이 문서에서는 로컬 워크스테이션에서 Azure로 코드를 배포하는 방법에 중점을 둡니다.

이전 단계에서 Azure CLI 명령어로 리소스를 생성하고 애플리케이션을 배포했습니다. 다음 단계로 넘어가도 됩니다.

애플리케이션 코드의 ZIP 파일을 만들고 Azure에 업로드하여 애플리케이션을 Azure에 배포할 수 있습니다. ZIP 파일은 Azure CLI 또는 cURL과 같은 HTTP 클라이언트를 사용하여 Azure에 업로드할 수 있습니다.

빌드 자동화 사용

Python 코드의 ZIP 파일을 배포할 때 Azure의 빌드 자동화를 사용하도록 플래그를 설정해야 합니다. 빌드 자동화는 필요한 요구 사항을 설치하고 Azure에서 실행되도록 애플리케이션을 패키지합니다.

Azure에서 빌드 자동화는 Azure Portal 또는 Azure CLI에서 SCM_DO_BUILD_DURING_DEPLOYMENT 앱 설정을 설정하여 사용하도록 설정됩니다.

Azure Portal
Azure CLI

지시	스크린샷
Azure Portal의 웹앱에 대한 페이지에서 다음을 수행합니다. 왼쪽 도구 모음의 설정 헤더 아래에서 구성을 선택하여 애플리케이션 설정을 표시합니다. 애플리케이션 설정에서 새 애플리케이션 설정을 선택합니다.
대화 상자에서 다음을 사용하여 새 설정을 입력합니다. 이름 → SCM_DO_BUILD_DURING_DEPLOYMENT 값 → true
저장을 선택하여 설정을 저장합니다.

az webapp config appsettings set 명령을 사용하여 SCM_DO_BUILD_DURING_DEPLOYMENT 설정을 true의 값으로 설정합니다.

bash
PowerShell 터미널

# 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 config appsettings set \
    --resource-group $RESOURCE_GROUP_NAME \
    --name $APP_SERVICE_NAME \
    --settings SCM_DO_BUILD_DURING_DEPLOYMENT=true

# 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 config appsettings set `
    --resource-group $resourceGroupName `
    --name $appServiceName `
    --settings SCM_DO_BUILD_DURING_DEPLOYMENT=true

애플리케이션의 ZIP 파일 만들기

다음으로, 애플리케이션의 ZIP 파일을 만듭니다. 애플리케이션 자체의 구성 요소만 포함하면 됩니다. 점(.)(예: .venv, .gitignore, .github 또는 .vscode)로 시작하는 파일 또는 디렉터리를 포함할 필요가 없습니다.

Windows
macOS/Linux

Windows에서는 7-Zip과 같은 프로그램을 사용하여 애플리케이션을 배포하는 데 필요한 ZIP 파일을 만듭니다.

macOS 또는 Linux에서 기본 제공 zip 유틸리티를 사용하여 ZIP 파일을 만들 수 있습니다.

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

ZIP 파일을 Azure에 업로드

ZIP 파일이 있으면 Azure CLI 또는 cURL과 같은 HTTP 클라이언트를 사용하여 Azure에 파일을 업로드할 수 있습니다.

Azure CLI
씨유알엘

az webapp deploy 명령을 사용하여 Azure에 ZIP 파일을 업로드하고 배포할 수 있습니다.

bash
PowerShell 터미널

# 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을 사용하여 ZIP 파일을 Azure에 업로드하려면 App Service에 대한 배포 사용자 이름 및 암호가 필요합니다. 이러한 자격 증명은 Azure Portal에서 가져올 수 있습니다.

웹앱 페이지에서 페이지 왼쪽에 있는 메뉴에서 배포 센터를 선택합니다.
FTPS 자격 증명 탭을 선택합니다.
사용자 이름 및 암호는 애플리케이션 범위 제목 아래에 표시됩니다. ZIP 파일 배포의 경우 \로 시작하는 $ 문자 뒤의 사용자 이름 부분만 사용합니다. 예를 들면 $msdocs-python-webapp-quickstart-123입니다. 이러한 자격 증명은 cURL 명령에 필요합니다.

다음 curl 명령을 실행하여 ZIP 파일을 Azure에 업로드하고 애플리케이션을 배포합니다. 사용자 이름은 3단계에서 얻은 배포 사용자 이름입니다. 이 명령을 실행하면 배포 암호를 묻는 메시지가 표시됩니다.

Kudu 환경에서 <URL>을 가져옵니다.

Azure Portal에서 앱을 열고 개발 도구> 선택한 다음, 이동을 선택합니다.
주소 표시줄에서 값을 복사하고 /api/zipdeploy를 추가합니다.

bash
PowerShell 터미널

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

PowerShell의 경우 PowerShell에서 사용자 이름을 PowerShell 변수로 해석하지 않도록 사용자 이름을 작은따옴표로 묶습니다.

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

네트워크 대역폭에 따라 파일은 일반적으로 Azure에 업로드하는 데 10~30초 정도 걸립니다.

문제가 있나요? 먼저 문제 해결 가이드를 참조하세요. 도움이 되지 않으면 알려주세요.

시작 스크립트 구성

배포에 특정 파일이 있는지에 따라, App Service는 앱이 Django 앱인지 또는 Flask 앱인지를 자동으로 감지하고 기본 단계를 수행하여 앱을 실행합니다. FastAPI 같은 다른 웹 프레임워크 기반의 앱이라면, App Service가 실행되도록 시작 스크립트를 설정해야 할 수도 있습니다. 그렇지 않으면 App Service는 opt/defaultsite 폴더에 있는 기본 읽기 전용 앱을 실행합니다.

Python 3.14 이후: App Service가 FastAPI 앱을 자동으로 감지하고 실행합니다. 시작 명령은 필요하지 않습니다.
Python 3.13 이하: 사용자 지정 시작 명령어를 설정해야 합니다.

App Service에서 Python 앱을 실행하는 방법과 앱에서 해당 동작을 구성하고 사용자 지정하는 방법에 대한 자세한 내용은 Azure App Service용 Linux Python 앱 구성을 참조하세요.

App Service는 Flask 앱의 존재를 자동으로 감지합니다. 이 빠른 시작을 위해 추가 구성이 필요하지 않습니다.

Python 3.14 이후를 사용 중이라면, App Service가 자동으로 FastAPI 앱을 감지하고 실행합니다. 이 퀵스타트에는 추가 설정이 필요하지 않습니다.

Python 3.13 이전 버전을 사용 중이라면, App Service가 앱을 실행하려면 커스텀 시작 명령을 설정해야 합니다. 다음 명령어는 Gunicorn을 두 개의 Uvicorn 워커 프로세스로 시작합니다: gunicorn -w 2 -k uvicorn.workers.UvicornWorker -b 0.0.0.0:8000 main:app.

먼저 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

다음으로, az webapp restart 명령을 사용하여 웹앱을 다시 시작합니다.

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

Python 3.14 이후를 사용 중이라면, App Service가 자동으로 FastAPI 앱을 감지하고 실행합니다. 이 퀵스타트에는 추가 설정이 필요 없습니다.

지시	스크린샷
Python 3.13 이전 버전을 사용 중이라면, Azure App Service에서 시작 명령을 설정하세요. Azure 포털에서 App Service 인스턴스로 가세요. 페이지 왼쪽 메뉴의 설정 제목 아래에서 구성을 선택합니다. 일반 설정 탭이 선택되어 있는지 확인합니다. 시작 명령 필드에 gunicorn -w 2 -k uvicorn.workers.UvicornWorker -b 0.0.0.0:8000 main:app을 입력합니다. 저장을 선택하여 변경 내용을 저장합니다. 계속하기 전에 설정이 업데이트되었다는 알림을 기다립니다. Python 3.14 이상을 사용 중이라면 시작 명령이 필요하지 않습니다.
다음으로, 웹앱을 다시 시작합니다. 페이지 왼쪽의 메뉴에서 개요를 선택합니다. 위쪽 메뉴에서 다시 시작을 선택합니다.

지시

스크린샷

Python 3.13 이전 버전을 사용 중이라면, Azure App Service에서 시작 명령을 설정하세요. Azure 포털에서 App Service 인스턴스로 가세요.

페이지 왼쪽 메뉴의 설정 제목 아래에서 구성을 선택합니다.
일반 설정 탭이 선택되어 있는지 확인합니다.
시작 명령 필드에 gunicorn -w 2 -k uvicorn.workers.UvicornWorker -b 0.0.0.0:8000 main:app을 입력합니다.
저장을 선택하여 변경 내용을 저장합니다.
계속하기 전에 설정이 업데이트되었다는 알림을 기다립니다.

Python 3.14 이상을 사용 중이라면 시작 명령이 필요하지 않습니다.

Azure Portal에서 시작 명령을 구성할 위치를 보여 주는 스크린샷

다음으로, 웹앱을 다시 시작합니다.

페이지 왼쪽의 메뉴에서 개요를 선택합니다.
위쪽 메뉴에서 다시 시작을 선택합니다.

앱으로 이동

웹 브라우저에서 배포된 애플리케이션으로 이동합니다. Azure Portal에서 링크를 따를 수 있습니다. 개요 페이지로 이동하여 기본 도메인을 선택합니다. 기본 앱 페이지가 보이면 1분을 기다렸다가 브라우저를 새로 고칩니다.

Python 샘플 코드가 기본 제공 이미지를 사용하여 App Service에서 Linux 컨테이너를 실행 중입니다.

Azure에서 실행되는 앱의 스크린샷.

축하합니다! Python 앱을 App Service에 배포했습니다.

문제가 있나요? 먼저 문제 해결 가이드를 참조하세요. 도움이 되지 않으면 알려주세요.

로그 스트리밍

Azure App Service는 애플리케이션 문제를 진단하는 데 도움이 되도록 콘솔에 모든 메시지 출력을 캡처합니다. 샘플 앱에는 이 기능을 보여주는 print() 문이 포함되어 있습니다.

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

Azure CLI, VS Code 또는 Azure Portal을 사용하여 App Service 진단 로그의 내용을 검토할 수 있습니다.

먼저 az webapp log config 명령을 사용하여 App Service 파일 시스템에 로그를 출력하도록 Azure App Service를 구성해야 합니다.

bash
PowerShell 터미널

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

로그를 스트리밍하려면 az webapp log tail 명령을 사용합니다.

bash
PowerShell 터미널

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

앱에서 홈페이지를 새로 고치거나 다른 요청을 시도하여 일부 로그 메시지를 생성합니다. 출력은 다음과 비슷하게 표시됩니다.

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"

지시	스크린샷
먼저, Azure App Service에서 스트리밍 로그를 사용하도록 설정해야 합니다. Azure Tools for VS Code 확장의 App Service 섹션에서 App Service 인스턴스를 마우스 오른쪽 단추로 클릭하고 메뉴에서 스트리밍 로그 시작을 선택합니다.
콘솔 로그가 VS Code 출력 창에 표시됩니다. 앱에서 홈페이지를 새로 고치거나 다른 요청을 시도하여 일부 로그 메시지를 생성합니다. 앱에서 생성된 로그 메시지와 서비스에서 생성된 다른 메시지가 출력에 표시됩니다.

지시	스크린샷
먼저, Azure App Service에서 스트리밍 로그를 사용하도록 설정해야 합니다. Azure Portal에서 App Service 인스턴스의 페이지로 이동합니다. 페이지 왼쪽 메뉴의 모니터링 제목 아래에서 App Service 로그를 선택합니다. 애플리케이션 로깅 속성을 끄기에서 파일 시스템으로 변경합니다. 로그에 대해 30일의 보존 기간을 입력합니다. 저장을 선택하여 변경 내용을 저장합니다.
왼쪽 탐색 창의 모니터링 섹션에서 로그 스트림을 선택합니다. 앱에서 홈페이지를 새로 고치거나 다른 요청을 시도하여 일부 로그 메시지를 생성합니다. 앱에서 생성된 로그 메시지와 서비스에서 생성한 메시지가 출력에 표시됩니다.

지시

스크린샷

먼저, Azure App Service에서 스트리밍 로그를 사용하도록 설정해야 합니다. Azure Portal에서 App Service 인스턴스의 페이지로 이동합니다.

페이지 왼쪽 메뉴의 모니터링 제목 아래에서 App Service 로그를 선택합니다.
애플리케이션 로깅 속성을 끄기에서 파일 시스템으로 변경합니다.
로그에 대해 30일의 보존 기간을 입력합니다.
저장을 선택하여 변경 내용을 저장합니다.

스트리밍 로그를 사용하도록 설정하는 Azure Portal의 위치 스크린샷.

왼쪽 탐색 창의 모니터링 섹션에서 로그 스트림을 선택합니다. 앱에서 홈페이지를 새로 고치거나 다른 요청을 시도하여 일부 로그 메시지를 생성합니다.

앱에서 생성된 로그 메시지와 서비스에서 생성한 메시지가 출력에 표시됩니다.

문제가 있나요? 먼저 문제 해결 가이드를 참조하세요. 도움이 되지 않으면 알려주세요.

리소스 정리

샘플 앱을 마쳤으면 Azure에서 앱에 대한 모든 리소스를 제거해도 됩니다. 리소스 그룹을 제거하면 추가 요금이 발생하지 않으며 Azure 구독을 깔끔하게 유지하는 데 도움이 됩니다. 리소스 그룹을 제거하면 리소스 그룹의 모든 리소스도 제거되며 이것이 앱에 대한 모든 Azure 리소스를 제거하는 가장 빠른 방법입니다.

az group delete 명령을 사용하여 리소스 그룹을 삭제합니다.

az group delete \
    --name msdocs-python-webapp-quickstart \
    --no-wait

--no-wait 인수를 사용하면 작업이 완료되기 전에 명령을 반환할 수 있습니다.

지시	스크린샷
VS Code용 Azure Tools 확장에서 다음을 수행합니다. RESOURCES 섹션을 찾습니다. 그룹화 기준 아이콘을 선택하고 리소스 그룹별 그룹화를 선택합니다.
리소스 목록에서 삭제할 리소스 그룹을 찾아 마우스 오른쪽 단추로 클릭하고 리소스 그룹 삭제...를 선택합니다. 대화 상자에 리소스 그룹 이름을 입력하여 삭제를 확인하라는 메시지가 표시됩니다.

Azure Portal에 로그인하는 동안 다음 단계에 따라 리소스 그룹을 삭제합니다.

지시	스크린샷
Azure Portal에서 리소스 그룹으로 이동합니다. 페이지 맨 위에 있는 검색 창에 리소스 그룹의 이름을 입력합니다. 리소스 그룹 머리글 아래에서 리소스 그룹의 이름을 선택하여 해당 이름으로 이동합니다.
페이지 맨 위에서 리소스 그룹 삭제 단추를 선택합니다.
확인 대화 상자에서 리소스 그룹의 이름을 입력하여 삭제를 확인합니다. 삭제를 선택하여 리소스 그룹을 삭제합니다.