Azure에서 PostgreSQL을 사용하여 Python(Django 또는 Flask) 웹앱 배포

이 자습서에서는 Azure Database for PostgreSQL 관계형 데이터베이스 서비스를 사용하여 데이터 기반 Python 웹앱(Django 또는 Flask)을 Azure App Service에 배포합니다. Azure App Service는 Linux 서버 환경에서 Python 3.7 이상을 지원합니다.

Azure에서 PostgreSQL 데이터베이스가 있는 App Service를 보여 주는 아키텍처 다이어그램.

이 자습서를 완료하려면 다음이 필요합니다.

애플리케이션 예제

제공된 Flask 및 Django 프레임워크를 사용하는 샘플 Python 애플리케이션은 이 자습서를 따라가는 데 도움이 됩니다. 로컬로 실행하지 않고 배포하려면 이 부분을 건너뜁니다.

애플리케이션을 로컬로 실행하려면 Python 3.7 이상PostgreSQL 이 로컬로 설치되어 있는지 확인합니다. 그런 다음, 앱을 다운로드하거나 복제합니다.

git clone https://github.com/Azure-Samples/msdocs-flask-postgresql-sample-app.git

다음과 같이 애플리케이션 폴더로 이동합니다.

cd msdocs-python-flask-webapp-quickstart

.env.sample 파일을 가이드로 사용하여 아래와 같이 .env 파일을 만듭니다. DBNAME의 값을 로컬 PostgreSQL 인스턴스의 기존 데이터베이스 이름으로 설정합니다. DBHOST, DBUSER, DBPASS의 값을 로컬 PostgreSQL 인스턴스에 적절하게 설정합니다.

DBNAME=<database name>
DBHOST=<database-hostname>
DBUSER=<db-user-name>
DBPASS=<db-password>

터미널 프롬프트 python -c 'import secrets; print(secrets.token_hex())'에서 명령을 실행하여 앱에 대한 SECRET_KEY 값을 만듭니다.

반환된 값을 .env 파일의 SECRET_KEY 값으로 설정합니다.

SECRET_KEY=<secret-key>

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

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

종속성을 설치합니다.

pip install -r requirements.txt

다음 명령을 사용하여 샘플 애플리케이션을 실행합니다.

# Run database migration
flask db upgrade
# Run the app at http://127.0.0.1:5000
flask run

1. App Service 및 PostgreSQL 만들기

이 단계에서는 Azure 리소스를 만듭니다. 이 자습서에 사용된 단계에서는 App Service 및 Azure Database for PostgreSQL을 포함하는 기본 보안 리소스 세트를 만듭니다. 만들기 프로세스의 경우 다음을 지정합니다.

  • 웹앱의 이름입니다. https://<app-name>.azurewebsites.net 형식의 웹앱의 DNS 이름의 일부로 사용되는 이름입니다.
  • 전 세계에서 앱을 물리적으로 실행할 지역입니다.
  • 앱의 런타임 스택입니다. 여기에서 앱에 사용할 Python 버전을 선택합니다.
  • 앱에 대한 호스팅 계획입니다. 앱에 대한 기능 및 크기 조정 용량 세트를 포함하는 가격 책정 계층입니다.
  • 앱의 리소스 그룹입니다. 리소스 그룹을 사용하면 애플리케이션에 필요한 모든 Azure 리소스를 논리 컨테이너에 그룹화할 수 있습니다.

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

1단계: Azure Portal에서 다음을 수행합니다.

  1. Azure Portal 상단의 검색 창에 "웹앱 데이터베이스"를 입력합니다.
  2. Marketplace 제목 아래에서 웹앱 + 데이터베이스라는 항목을 선택합니다. 만들기 마법사로 직접 이동할 수도 있습니다.

웹앱 + 데이터베이스 만들기 마법사를 찾기 위해 상단 도구 모음의 검색 상자를 사용하는 방법을 보여 주는 스크린샷.

2단계. 웹앱 + 데이터베이스 만들기 페이지에서 다음과 같이 양식을 작성합니다.

  1. 리소스 그룹새로 만들기를 선택하고 msdocs-python-postgres-tutorial의 이름을 사용합니다.
  2. 지역 → 가까운 모든 Azure 지역입니다.
  3. 이름msdocs-python-postgres-XYZ를 선택합니다. 여기서 XYZ는 임의의 세 문자입니다. 이 이름은 Azure에서 고유해야 합니다.
  4. 런타임 스택Python 3.10.
  5. 데이터베이스PostgreSQL - 유연한 서버 는 기본적으로 데이터베이스 엔진으로 선택됩니다. 서버 이름 및 데이터베이스 이름도 기본적으로 적절한 값으로 설정됩니다.
  6. 호스팅 계획기본. 준비가 되면 나중에 프로덕션 가격 책정 계층으로 스케일 업할 수 있습니다.
  7. 검토 + 만들기를 선택합니다.
  8. 유효성 검사가 완료되면 만들기를 선택합니다.

웹앱 + 데이터베이스 마법사에서 새 앱과 데이터베이스를 구성하는 방법을 보여 주는 스크린샷.

3단계: 배포를 완료하는 데 몇 분이 걸립니다. 배포가 완료되면 리소스로 이동 단추를 선택합니다. App Service 앱으로 직접 이동하지만 다음 리소스가 생성됩니다.

  • 리소스 그룹 → 만들어진 모든 리소스의 컨테이너입니다.
  • App Service 요금제 → App Service의 컴퓨팅 리소스를 정의합니다. 기본 계층의 Linux 계획이 만들어집니다.
  • App Service → 앱을 나타내며 App Service 요금제에서 실행됩니다.
  • 가상 네트워크 → App Service 앱과 통합되고 백 엔드 네트워크 트래픽을 격리합니다.
  • Azure Database for PostgreSQL 유연한 서버 → 가상 네트워크 내에서만 액세스할 수 있습니다. 서버에 데이터베이스와 사용자가 만들어집니다.
  • 프라이빗 DNS 영역 → 가상 네트워크에서 PostgreSQL 서버의 DNS 확인을 사용하도록 설정합니다.

완료된 배포 프로세스를 보여 주는 스크린샷.

2. 연결 설정 확인

생성 마법사는 이미 앱 설정으로 연결 변수를 생성했습니다. 앱 설정은 코드 리포지토리에서 연결 비밀을 유지하는 한 가지 방법입니다. 비밀을 더 안전한 위치로 이동할 준비가 되면 Azure Key Vault 저장에 대한 문서는 다음과 같습니다.

1단계: App Service 페이지의 왼쪽 메뉴에서 구성을 선택합니다.

App Service에서 구성 페이지를 여는 방법을 보여 주는 스크린샷.

2단계. 구성 페이지의 애플리케이션 설정 탭에서 이 있는지 AZURE_POSTGRESQL_CONNECTIONSTRING 확인합니다. 이는 런타임 환경에 환경 변수로 삽입됩니다.

자동 생성된 연결 문자열을 보는 방법을 보여 주는 스크린샷.

3단계: 터미널 또는 명령 프롬프트에서 다음 Python 스크립트를 실행하여 고유한 비밀을 python -c 'import secrets; print(secrets.token_hex())'생성합니다. 다음 단계에서 사용할 출력 값을 복사합니다.

4단계. 구성 페이지의 애플리케이션 설정 탭에서 새 애플리케이션 설정을 선택합니다. 설정 이름을 로 지정합니다 SECRET_KEY. 이전 값의 값을 붙여넣습니다. 확인을 선택합니다.

Azure Portal SECRET_KEY 앱 설정을 보여 주는 스크린샷

5단계. 저장을 선택합니다.

Azure Portal SECRET_KEY 앱 설정을 저장하는 방법을 보여 주는 스크린샷

문제가 있나요? 문제 해결 가이드를 확인합니다.

3. 샘플 코드 배포

이 단계에서는 GitHub Actions을 사용하여 GitHub 배포를 구성합니다. 이는 App Service에 배포하는 여러 방법 중 하나일 뿐 아니라 배포 프로세스에서 연속적으로 통합할 수 있는 좋은 방법이기도 합니다. 기본적으로 GitHub 리포지토리에 대한 모든 git push는 빌드 및 배포 작업을 시작합니다.

1단계: 새 브라우저 창에서:

  1. GitHub 계정에 로그인합니다.
  2. https://github.com/Azure-Samples/msdocs-flask-postgresql-sample-app로 이동합니다.
  3. 포크를 선택합니다.
  4. 포크 만들기를 선택합니다.

샘플 GitHub 리포지토리의 포크를 만드는 방법을 보여 주는 스크린샷(Flask).

2단계. GitHub 페이지에서 . 키를 눌러 브라우저에서 Visual Studio Code를 엽니다.

GitHub에서 Visual Studio Code 브라우저 환경을 여는 방법을 보여 주는 스크린샷(Flask).

3단계: 브라우저의 Visual Studio Code에서 탐색기에 있는 azureproject/production.py를 엽니다. 구성 페이지에서 확인한 앱 설정을 포함하여 프로덕션 환경에서 사용되는 환경 변수를 참조하세요.

브라우저의 Visual Studio Code와 열린 파일을 보여 주는 스크린샷(Flask).

4단계. App Service 페이지로 돌아가 왼쪽 메뉴에서 배포 센터를 선택합니다.

App Service에서 배포 센터를 여는 방법을 보여 주는 스크린샷(Flask).

5단계. 배포 센터 페이지에서 다음을 수행합니다.

  1. 원본에서 GitHub를 선택합니다. 기본적으로 GitHub Actions이 빌드 공급자로 선택됩니다.
  2. GitHub 계정에 로그인하고 프롬프트에 따라 Azure를 인증합니다.
  3. 조직에서 계정을 선택합니다.
  4. 리포지토리에서 msdocs-flask-postgresql-sample-app을 선택합니다.
  5. 분기에서 기본을 선택합니다.
  6. 워크플로 추가에 대해 기본 옵션을 선택한 상태로 유지합니다.
  7. 상단 메뉴에서 저장을 선택합니다. App Service는 .github/workflows 디렉터리의 선택한 GitHub 리포지토리에 워크플로 파일을 커밋합니다.

GitHub Actions를 사용하여 CI/CD를 구성하는 방법을 보여 주는 스크린샷(Flask).

6단계. 배포 센터 페이지에서 다음을 수행합니다.

  1. 로그를 선택합니다. 배포 실행이 이미 시작되었습니다.
  2. 배포 실행에 대한 로그 항목에서 로그 빌드/배포를 선택합니다.

배포 센터에서 배포 로그를 여는 방법을 보여 주는 스크린샷(Flask).

7단계. GitHub 리포지토리로 이동하고 GitHub 작업이 실행 중임을 확인합니다. 워크플로 파일은 빌드 및 배포라는 두 가지 개별 단계를 정의합니다. GitHub 실행이 완료 상태를 표시할 때까지 기다립니다. 약 5분 정도 소요됩니다.

진행 중인 GitHub 실행을 보여 주는 스크린샷(Flask).

문제가 있나요? 문제 해결 가이드를 확인합니다.

4. 데이터베이스 스키마 생성

가상 네트워크에서 보호되는 PostgreSQL 데이터베이스를 사용하면 Flask 데이터베이스 마이그레이션을 실행하는 가장 쉬운 방법은 App Service 컨테이너가 있는 SSH 세션에 있습니다.

1단계: App Service 페이지로 돌아가서 왼쪽 메뉴에서 SSH를 선택합니다.

  1. 이동을 선택합니다.

Azure Portal에서 앱의 SSH 셸을 여는 방법을 보여 주는 스크린샷(Flask).

2단계. SSH 터미널에서 flask db upgrade를 실행합니다. 성공하면 App Service가 데이터베이스에 성공적으로 연결됩니다. /home의 파일에 대한 변경 내용만 앱을 다시 시작한 후에도 유지될 수 있습니다. /home 외의 변경 내용은 유지되지 않습니다.

SSH 셸에서 실행할 명령과 해당 출력을 보여 주는 스크린샷(Flask).

5. 앱으로 이동

1단계: App Service 페이지에서:

  1. 왼쪽 메뉴에서 개요를 선택합니다.
  2. 앱의 URL을 선택합니다. https://<app-name>.azurewebsites.net으로 직접 이동할 수도 있습니다.

Azure Portal에서 App Service를 시작하는 방법을 보여 주는 스크린샷.

2단계. 목록에 몇 가지 레스토랑을 추가합니다. 축하합니다. Azure Database for PostgreSQL 대한 보안 연결을 사용하여 Azure App Service 웹앱을 실행하고 있습니다.

레스토랑 및 레스토랑 리뷰를 보여 주는 Azure에서 실행되는 PostgreSQL을 사용하는 Flask 웹앱의 스크린샷

6. 진단 로그 스트림

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

@app.route('/', methods=['GET'])
def index():
    print('Request for index page received')
    restaurants = Restaurant.query.all()
    return render_template('index.html', restaurants=restaurants)

1단계: App Service 페이지에서:

  1. 왼쪽 메뉴에서 App Service 로그를 선택합니다.
  2. 애플리케이션 로깅에서 파일 시스템을 선택합니다.
  3. 상단 메뉴에서 저장을 선택합니다.

Azure Portal의 App Service에서 네이티브 로그를 사용하도록 설정하는 방법을 보여 주는 스크린샷.

2단계. 왼쪽 메뉴에서 로그 스트림을 선택합니다. 플랫폼 로그 및 컨테이너 내부의 로그를 포함하여 앱에 대한 로그가 표시됩니다.

Azure Portal에서 로그 스트림을 보는 방법을 보여 주는 스크린샷.

Python 애플리케이션에 대한 Azure Monitor 설정에 대한 시리즈의 Python 앱 로깅에 대해 자세히 알아봅니다.

7. 리소스 정리

완료되면 리소스 그룹을 삭제하여 Azure 구독에서 모든 리소스를 삭제할 수 있습니다.

1단계: Azure Portal 맨 위에 있는 검색 창에서:

  1. 리소스 그룹 이름을 입력합니다.
  2. 리소스 그룹을 선택합니다.

Azure Portal에서 리소스 그룹을 검색하고 탐색하는 방법을 보여 주는 스크린샷.

2단계. 리소스 그룹 페이지에서 리소스 그룹 삭제를 선택합니다.

Azure Portal에서 리소스 그룹 삭제 단추의 위치를 보여 주는 스크린샷.

3단계.

  1. 리소스 그룹 이름을 입력하여 삭제를 확인합니다.
  2. 삭제를 선택합니다.

Azure Portal에서 리소스 그룹 삭제를 확인하는 대화 상자를 보여주는 스크린샷. :

문제 해결

아래에는 이 자습서를 진행하는 동안 발생할 수 있는 문제 및 해결 단계가 나와 있습니다.

SSH 세션에 연결할 수 없음

SSH 세션에 연결할 수 없으면 앱 자체를 시작하지 못한 것입니다. 자세한 내용은 진단 로그를 확인하세요. 예를 들어 KeyError: 'AZURE_POSTGRESQL_CONNECTIONSTRING'와 같은 오류가 표시되면 환경 변수가 누락된 것일 수 있습니다(앱 설정을 제거했을 수 있음).

데이터베이스 마이그레이션을 실행하는 동안 오류 발생

데이터베이스 연결과 관련된 오류가 발생하는 경우 앱 설정(AZURE_POSTGRESQL_CONNECTIONSTRING)이 변경되었는지 확인합니다. 해당 연결 문자열이 없으면 migrate 명령이 데이터베이스와 통신할 수 없습니다.

Azure Developer CLI 사용하여 프로비전 및 배포

이 자습서에서는 Flask 및 Django 프레임워크를 사용하는 샘플 Python 애플리케이션 템플릿이 제공됩니다. 이 Azure Developer CLI 애플리케이션 리소스를 프로비전하고 Azure에 코드를 배포하는 프로세스를 크게 간소화합니다. Azure Portal 및 기타 도구를 사용하는 단계별 접근 방식을 보려면 페이지 맨 위에 있는 Azure Portal 접근 방식으로 전환합니다.

Azure Developer CLI(azd)는 실제 Azure 리소스에 대해 실행하기 위해 CI/CD 파이프라인을 초기화, 프로비전, 배포, 모니터링 및 스캐폴딩하는 엔드투엔드 지원을 제공합니다. 를 사용하여 azd 자동화되고 간소화된 방식으로 샘플 애플리케이션에 대한 리소스를 프로비전하고 배포할 수 있습니다.

아래 단계에 따라 Azure Developer CLI 설치하고 샘플 애플리케이션을 프로비전하고 배포합니다.

  1. Azure Developer CLI 설치합니다. 지원되는 설치 옵션 및 도구의 전체 목록은 설치 가이드를 참조하세요.

    powershell -ex AllSigned -c "Invoke-RestMethod 'https://aka.ms/install-azd.ps1' | Invoke-Expression"
    
  2. azd up 명령을 실행하여 앱 리소스를 복제, 프로비전 및 배포합니다. 매개 변수에 사용할 --template 템플릿의 이름을 제공합니다. 또한 명령은 azd up Azure에 로그인하고 앱의 이름과 위치를 제공하라는 메시지를 표시합니다.

    azd up --template msdocs-flask-postgresql-sample-app
    
  3. 명령 실행이 azd up 완료되면 콘솔에서 배포된 웹앱의 URL이 인쇄됩니다. 웹앱 URL을 클릭하거나 복사하여 브라우저에 붙여넣어 실행 중인 앱을 탐색하고 제대로 작동하는지 확인합니다. 모든 Azure 리소스 및 애플리케이션 코드가 명령에 의해 azd up 설정되었습니다.

    생성된 리소스 그룹의 이름도 콘솔 출력에 표시됩니다. Azure Portal 리소스 그룹을 찾아 프로비전된 모든 리소스를 확인합니다.

    Azure Developer CLI 배포된 리소스를 보여 주는 스크린샷

또한 Azure Developer CLI 배포에 CI/CD 파이프라인을 사용하도록 애플리케이션을 구성하고, 모니터링 기능을 설정하며, 모든 항목을 제거하려는 경우 프로비전된 리소스를 제거할 수도 있습니다. 이러한 추가 워크플로에 대한 자세한 내용은 프로젝트 추가 정보를 참조하세요.

완료된 azd 프로젝트 템플릿 워크플로 살펴보기

앞의 섹션에서는 더 자세히 처리된 단계를 azd 검토합니다. 이 워크플로를 탐색하여 Azure에 자체 앱을 배포하기 위한 요구 사항을 더 잘 이해할 수 있습니다. 를 실행azd up하면 Azure Developer CLI 다음 단계를 완료했습니다.

참고

이 흐름의 Azure Portal 버전에 설명된 단계를 사용하여 완료된 작업에 대한 추가 인사이 azd 트를 얻을 수도 있습니다.

1. 프로젝트 복제 및 초기화

명령은 azd up 샘플 앱 프로젝트 템플릿을 컴퓨터에 복제했습니다. 프로젝트 템플릿에는 다음 구성 요소가 포함됩니다.

  • 소스 코드: 로컬 개발에 사용하거나 Azure에 배포할 수 있는 Flask 또는 Django 웹앱의 코드 및 자산입니다.
  • Bicep 파일: Azure에서 필요한 리소스를 만드는 데 사용되는 azd IaC(Infrastructure as Code) 파일입니다.
  • 구성 파일: 리소스를 프로비전, 배포 및 연결하여 완전히 본격적인 애플리케이션을 생성하는 데 사용되는 azd 와 같은 azure.yaml 필수 구성 파일입니다.

2. Azure 리소스 프로비전

명령은 azd up 프로젝트 템플릿의 폴더에 있는 Bicep 파일을 사용하여 Azure에서 샘플 애플리케이션에 infra 대한 모든 리소스를 만들었습니다. Bicep 은 Azure에서 코드로서의 인프라를 관리하는 데 사용되는 선언적 언어입니다. 템플릿에서 만든 주요 리소스 및 구성 중 일부는 다음과 같습니다.

  • 리소스 그룹: 프로비전된 다른 모든 Azure 리소스를 보유하기 위해 리소스 그룹이 만들어졌습니다. 리소스 그룹은 리소스를 잘 구성하고 관리하기 쉽게 유지합니다. 리소스 그룹의 이름은 초기화 프로세스 중에 azd up 지정한 환경 이름을 기반으로 합니다.
  • Azure Virtual Network: 프로비전된 리소스가 안전하게 연결하고 서로 통신할 수 있도록 가상 네트워크를 만들었습니다. 프라이빗 DNS 영역 링크 설정과 같은 관련 구성도 적용되었습니다.
  • Azure App Service 계획: App Service 인스턴스를 호스트하는 App Service 계획이 만들어졌습니다. App Service 계획은 하나 이상의 웹앱에 사용할 수 있는 컴퓨팅 리소스를 정의합니다.
  • Azure App Service: 배포된 애플리케이션을 호스트하고 실행하기 위한 새 App Service 계획에서 App Service 인스턴스가 만들어졌습니다. 이 경우 Linux 인스턴스가 만들어지고 Python 앱을 실행하도록 구성되었습니다. Postgres 연결 문자열 및 비밀 키 설정과 같은 추가 구성도 앱 서비스에 적용되었습니다.
  • Azure Database for PostgresSQL: 연결할 App Service 호스트되는 앱에 대해 Postgres 데이터베이스 및 서버가 만들어졌습니다. 필요한 관리 사용자, 네트워크 및 연결 설정도 구성되었습니다.
  • Azure 애플리케이션 Insights: App Service 호스트되는 앱에 대해 Application Insights가 설정되고 구성되었습니다. 이 서비스를 사용하면 애플리케이션에 대한 자세한 원격 분석 및 모니터링이 가능합니다.

프로젝트의 폴더에 있는 infra Bicep 파일을 검사하여 이러한 각 리소스가 프로비전된 방법을 자세히 이해할 수 있습니다. 파일은 resources.bicep Azure에서 만든 대부분의 다른 서비스를 정의합니다. 예를 들어 App Service 계획 및 App Service 웹앱 인스턴스는 다음 Bicep 코드를 사용하여 만들어지고 연결되었습니다.

resource appServicePlan 'Microsoft.Web/serverfarms@2021-03-01' = {
  name: '${prefix}-service-plan'
  location: location
  tags: tags
  sku: {
    name: 'B1'
  }
  properties: {
    reserved: true
  }
}

resource web 'Microsoft.Web/sites@2022-03-01' = {
  name: '${prefix}-app-service'
  location: location
  tags: union(tags, { 'azd-service-name': 'web' })
  kind: 'app,linux'
  properties: {
    serverFarmId: appServicePlan.id
    siteConfig: {
      alwaysOn: true
      linuxFxVersion: 'PYTHON|3.10'
      ftpsState: 'Disabled'
      appCommandLine: 'startup.sh'
    }
    httpsOnly: true
  }
  identity: {
    type: 'SystemAssigned'
  }

Azure Database for PostgreSQL 다음 Bicep을 사용하여 만들어졌습니다.

resource postgresServer 'Microsoft.DBforPostgreSQL/flexibleServers@2022-01-20-preview' = {
  location: location
  tags: tags
  name: pgServerName
  sku: {
    name: 'Standard_B1ms'
    tier: 'Burstable'
  }
  properties: {
    version: '12'
    administratorLogin: 'postgresadmin'
    administratorLoginPassword: databasePassword
    storage: {
      storageSizeGB: 128
    }
    backup: {
      backupRetentionDays: 7
      geoRedundantBackup: 'Disabled'
    }
    network: {
      delegatedSubnetResourceId: virtualNetwork::databaseSubnet.id
      privateDnsZoneArmResourceId: privateDnsZone.id
    }
    highAvailability: {
      mode: 'Disabled'
    }
    maintenanceWindow: {
      customWindow: 'Disabled'
      dayOfWeek: 0
      startHour: 0
      startMinute: 0
    }
  }

  dependsOn: [
    privateDnsZoneLink
  ]
}

3. 애플리케이션 배포

또한 명령은 azd up 프로비전된 Azure 리소스에 샘플 애플리케이션 코드를 배포했습니다. Developer CLI 프로젝트의 루트에 있는 파일을 사용하여 azure.yaml 애플리케이션 코드의 여러 부분을 Azure의 다른 서비스에 배포하는 방법을 이해합니다. 파일은 azure.yaml 앱 소스 코드 위치, 앱 유형 및 해당 앱을 호스트해야 하는 Azure 서비스를 지정합니다.

다음 azure.yaml 파일을 고려합니다. 이러한 구성은 프로젝트의 루트에 있는 Python 코드를 만든 App Service 배포해야 한다는 Azure Developer CLI 알려줍니다.

name: flask-postgresql-sample-app
metadata:
  template: flask-postgresql-sample-app@0.0.1-beta
services:
  web:
    project: .
    language: py
    host: appservice

리소스 제거

샘플 애플리케이션 실험이 완료되면 명령을 실행 azd down 하여 Azure에서 앱을 제거할 수 있습니다. 리소스를 제거하면 Azure 구독에서 의도하지 않은 비용 또는 사용되지 않는 서비스를 방지할 수 있습니다.

azd down

질문과 대답

이 설정 비용은 얼마인가요?

생성된 리소스에 대한 가격 책정은 다음과 같습니다.

  • App Service 요금제는 Basic 계층에서 만들어지며 스케일 업 또는 스케일 다운할 수 있습니다. App Service 가격 책정을 참조하세요.
  • PostgreSQL 유연한 서버는 확장 또는 축소할 수 있는 최소 스토리지 크기로 가장 낮은 버스트 가능 계층 Standard_B1ms 만들어집니다. Azure Database for PostgreSQL 가격 책정을 참조하세요.
  • 피어링과 같은 추가 기능을 구성하지 않는 한 가상 네트워크에는 요금이 발생하지 않습니다. Azure Virtual Network 가격 책정을 참조하세요.
  • 프라이빗 DNS 영역에는 약간의 요금이 청구됩니다. Azure DNS 가격 책정을 참조하세요.

다른 도구를 사용하여 가상 네트워크 뒤에서 보호되는 PostgreSQL 서버에 연결하려면 어떻게 해야 하나요?

  • 명령줄 도구에서 기본 액세스의 경우 앱의 SSH 터미널에서 psql을 실행할 수 있습니다.
  • 데스크톱 도구에서 연결하려면 컴퓨터가 가상 네트워크 내에 있어야 합니다. 예를 들어 서브넷 중 하나에 연결된 Azure VM이거나 Azure Virtual Network와 사이트 간 VPN 연결이 있는 온-프레미스 네트워크의 컴퓨터일 수 있습니다.
  • 가상 네트워크와 Azure Cloud Shell을 통합할 수도 있습니다.

로컬 앱 개발은 GitHub Actions와 어떻게 작동하나요?

App Service 자동 생성된 워크플로 파일을 예로 사용하여 각각 git push 새 빌드 및 배포 실행을 시작합니다. GitHub 리포지토리의 로컬 복제본에서 원하는 업데이트를 수행하고 GitHub로 푸시합니다. 다음은 그 예입니다.

git add .
git commit -m "<some-message>"
git push origin main

Django 샘플은 Azure App Service에서 실행되도록 어떻게 구성되어 있나요?

참고

이 자습서를 사용자 고유의 앱과 함께 사용하는 경우 각 프로젝트의 README.md 파일(Flask, Django)에서 requirements.txt 파일 설명을 확인하여 필요한 패키지를 확인하세요.

Django 샘플 애플리케이션은 Azure App Service에서 실행할 수 있도록 azureproject/production.py 파일의 설정을 구성합니다. 이러한 변경 내용은 프로덕션에 Django를 배포하는 데 일반적이며 App Service에만 국한되지 않습니다.

  • Django가 들어오는 요청에서 HTTP_HOST 헤더의 유효성을 검사합니다. 샘플 코드는 WEBSITE_HOSTNAME App Service의 환경 변수를 사용하여 Django의 ALLOWED_HOSTS 설정에 앱의 도메인 이름을 추가합니다.

    # Configure the domain name using the environment variable
    # that Azure automatically creates for us.
    ALLOWED_HOSTS = [os.environ['WEBSITE_HOSTNAME']] if 'WEBSITE_HOSTNAME' in os.environ else []
    
  • Django는 프로덕션에서 정적 파일 서비스를 지원하지 않습니다. 이 자습서에서는 WhiteNoise를 사용하여 파일 서비스를 사용하도록 설정합니다. WhiteNoise 패키지는 이미 requirements.txt와 함께 설치되었으며 해당 미들웨어가 목록에 추가되었습니다.

    
    # WhiteNoise configuration
    MIDDLEWARE = [
        'django.middleware.security.SecurityMiddleware',
        # Add whitenoise middleware after the security middleware
        'whitenoise.middleware.WhiteNoiseMiddleware',
    

    그런 다음, 정적 파일 설정은 Django 설명서에 따라 구성됩니다.

    STATICFILES_STORAGE = 'whitenoise.storage.CompressedManifestStaticFilesStorage'
    STATIC_ROOT = os.path.join(BASE_DIR, 'staticfiles')
    

자세한 내용은 Django 앱에 대한 프로덕션 설정을 참조하세요.

다음 단계

사용자 지정 도메인 및 인증서를 사용하여 앱을 보호하는 방법을 알아보려면 다음 자습서로 이동합니다.

App Service에서 Python 앱을 실행하는 방법을 알아봅니다.