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

• 활성 구독이 있는 Azure 계정. Azure 계정이 없으면 무료 계정을 만들 수 있습니다.
• Flask 개발이 포함된 Python 또는 Django 개발이 포함된 Python에 대한 지식

• 활성 구독이 있는 Azure 계정. Azure 계정이 없으면 무료 계정을 만들 수 있습니다.
• Azure 개발자 CLI를 설치해야 합니다. Azure Developer CLI가 이미 설치되어 있으므로 Azure Cloud Shell을 사용하여 단계를 수행할 수 있습니다.
• Flask 개발이 포함된 Python 또는 Django 개발이 포함된 Python에 대한 지식

1. App Service 및 PostgreSQL 만들기

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

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

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

2. 보안 연결 비밀

만들기 마법사는 이미 앱 설정으로 데이터베이스 연결 문자열을 생성했습니다. 그러나 보안을 위한 가장 좋은 방법은 App Service에서 비밀을 완전히 보호하는 것입니다. 비밀을 키 자격 증명 모음으로 이동하고 서비스 커넥터의 도움을 받아 앱 설정을 Key Vault 참조 로 변경합니다.

요약하자면, 이 프로세스에는 App Service의 환경 변수에서 PostgreSQL 연결 문자열 검색하고, 프라이빗 액세스를 사용하여 보안 비밀 관리를 위한 Azure Key Vault를 만들고, 키 자격 증명 모음에 암호를 저장하도록 서비스 커넥터를 업데이트하는 과정이 포함되었습니다. App Service 앱과 키 자격 증명 모음 간의 보안 연결은 시스템 할당 관리 ID를 사용하여 설정되었으며, 연결 문자열 Key Vault 참조를 사용하는지 확인하여 설치를 확인했습니다.

문제가 있나요? 문제 해결 섹션을 확인하세요.

3. 샘플 코드 배포

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

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

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

5. 앱으로 이동

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)

def index(request):
    print('Request for index page received')
    restaurants = Restaurant.objects.annotate(avg_rating=Avg('review__rating')).annotate(review_count=Count('review'))
    lastViewedRestaurant = request.session.get("lastViewedRestaurant", False)

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

7. 리소스 정리

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

1. Azure 리소스 만들기 및 샘플 앱 배포

이 단계에서는 Azure 리소스를 만들고 Linux의 App Service에 샘플 앱을 배포합니다. 이 자습서에 사용된 단계에서는 App Service 및 Azure Database for PostgreSQL을 포함하는 기본 보안 리소스 세트를 만듭니다.

1. 아직 로컬 터미널에서 샘플 리포지토리의 starter-no-infra 분기를 복제하지 않은 경우 복제합니다.

   • Flask
   • Django

   git clone -b starter-no-infra https://github.com/Azure-Samples/msdocs-flask-postgresql-sample-app
   cd msdocs-flask-postgresql-sample-app
   

   이 복제된 분기가 시작점입니다. 여기에는 간단한 데이터 기반 Flask 애플리케이션이 포함되어 있습니다.

2. 리포지토리 루트에서 azd init를 실행합니다.

   azd init --template python-app-service-postgresql-infra
   

3. 메시지가 표시되면 다음 답변을 제공합니다.

   질문	답변
   현재 디렉터리는 비어 있지 않습니다. '<your-directory>'에서 프로젝트를 초기화하시겠습니까?	예
   이러한 파일로 어떤 작업을 하고 싶나요?	기존 파일을 변경하지 않은 상태로 유지
   새 환경 이름 입력	고유한 이름을 입력합니다. azd 템플릿은 이 이름을 Azure(<app-name>.azurewebsites.net)에서 웹앱의 DNS 이름의 일부로 사용합니다. 영숫자 및 하이픈은 허용됩니다.

4. azd up 명령을 실행하여 필요한 Azure 리소스를 프로비전하고 앱 코드를 배포합니다. Azure에 아직 로그인하지 않은 경우 브라우저가 시작되고 로그인하라는 메시지가 표시됩니다. 또한 azd up 명령은 배포할 원하는 구독 및 위치를 선택하라는 메시지를 표시합니다.

   azd up
   

   azd up 명령을 완료하는 데 몇 분 정도 걸릴 수 있습니다. 또한 애플리케이션 코드가 컴파일 및 배포되지만 여기서는 나중에 App Service에서 작동하도록 코드를 수정할 것입니다. 실행되는 동안 명령은 Azure 배포에 대한 링크를 포함하여 프로비전 및 배포 프로세스에 대한 메시지를 제공합니다. 완료되면 명령은 배포 애플리케이션에 대한 링크도 표시합니다.

   이 azd 템플릿에는 다음 Azure 리소스를 사용하여 기본 보안 아키텍처를 생성하는 파일(azure.yaml 및 infra 디렉터리)이 포함되어 있습니다.

   • Flask
   • Django

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

2. 데이터베이스 연결 문자열 사용

사용하는 azd 템플릿은 사용자를 위해 연결 변수를 이미 앱 설정으로 생성했으며 편의를 위해 터미널에 출력합니다. 앱 설정은 코드 리포지토리에서 연결 비밀을 유지하는 좋은 방법입니다.

1. azd 출력에서 앱 설정을 찾아 설정 AZURE_POSTGRESQL_CONNECTIONSTRING 및 AZURE_REDIS_CONNECTIONSTRING을 찾습니다. 비밀을 안전하게 유지하기 위해 설정 이름만 표시됩니다. azd 출력에서 다음과 같이 표시됩니다.

    App Service app has the following settings:
   
            - AZURE_POSTGRESQL_CONNECTIONSTRING
            - AZURE_REDIS_CONNECTIONSTRING
            - FLASK_DEBUG
            - SCM_DO_BUILD_DURING_DEPLOYMENT
            - SECRET_KEY
    

2. AZURE_POSTGRESQL_CONNECTIONSTRING에는 Azure의 Postgres 데이터베이스에 대한 연결 문자열이 포함되며 AZURE_REDIS_CONNECTIONSTRING에는 Azure의 Redis 캐시에 대한 연결 문자열이 포함됩니다. 코드를 사용하여 연결해야 합니다. azureproject/production.py를 열고, 다음 줄의 주석 처리를 제거하고, 파일을 저장합니다.

   • Flask
   • Django

   conn_str = os.environ['AZURE_POSTGRESQL_CONNECTIONSTRING']
   conn_str_params = {pair.split('=')[0]: pair.split('=')[1] for pair in conn_str.split(' ')}
   DATABASE_URI = 'postgresql+psycopg2://{dbuser}:{dbpass}@{dbhost}/{dbname}'.format(
       dbuser=conn_str_params['user'],
       dbpass=conn_str_params['password'],
       dbhost=conn_str_params['host'],
       dbname=conn_str_params['dbname']
   )
   

   이제 애플리케이션 코드가 Azure의 PostgreSQL 데이터베이스에 연결하도록 구성되었습니다. 원할 경우 app.py를 열고 DATABASE_URI 환경 변수가 사용되는 방법을 확인합니다.

3. 터미널에서 azd deploy을 실행합니다.

   azd deploy
   

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

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

5. 앱으로 이동

1. azd 출력에서 앱의 URL을 찾은 후 브라우저에서 해당 위치로 이동합니다. URL은 AZD 출력에서 다음과 같습니다.

    Deploying services (azd deploy)
   
      (✓) Done: Deploying service web
      - Endpoint: https://<app-name>.azurewebsites.net/
    

2. 목록에 음식점 몇 개를 추가합니다.

   • Flask
   • Django

   

   축하합니다. Azure Database for PostgreSQL에 연결하여 Azure App Service의 웹앱을 실행하고 있습니다.

6. 진단 로그 스트림

Azure App Service는 애플리케이션 문제를 진단하는 데 도움이 되는 콘솔 로그를 캡처할 수 있습니다. 편의를 위해 azd 템플릿은 이미 로컬 파일 시스템에 로깅 및 Log Analytics 작업 영역으로 전달을 사용하도록 설정했습니다.

샘플 앱에는 다음 코드 조각과 같이 이 기능을 보여 주는 print() 문이 포함되어 있습니다.

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

def index(request):
    print('Request for index page received')
    restaurants = Restaurant.objects.annotate(avg_rating=Avg('review__rating')).annotate(review_count=Count('review'))
    lastViewedRestaurant = request.session.get("lastViewedRestaurant", False)

azd 출력에서 App Service 로그를 스트림하는 링크를 찾은 후 브라우저에서 해당 위치로 이동합니다. 링크는 azd 출력에서 다음과 같습니다.

Stream App Service logs at: https://portal.azure.com/#@/resource/subscriptions/<subscription-guid>/resourceGroups/<group-name>/providers/Microsoft.Web/sites/<app-name>/logStream

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

7. 리소스 정리

현재 배포 환경에서 모든 Azure 리소스를 삭제하려면 azd down을 실행합니다.

azd down