종속 항목 지정

Python 애플리케이션의 종속 항목은 표준 requirements.txt 파일에서 선언됩니다. 예를 들면 다음과 같습니다.

Flask==MAJOR.MINOR.PATCH
google-cloud-storage

MAJOR, MINOR, PATCH를 원하는 Flask 버전 번호로 바꿉니다.

기본(C) 확장 프로그램이 필요한 패키지를 포함하여 모든 Linux 호환 Python 패키지를 App Engine 가변형 환경에서 사용할 수 있습니다.

배포 중 Python 런타임이 requirements.txt에 선언된 모든 종속 항목을 자동으로 설치합니다.

로컬에서 종속 항목 설치

애플리케이션을 로컬에서 개발하고 테스트할 때는 venv를 사용하여 애플리케이션의 종속 항목을 시스템 패키지에서 격리하는 것이 좋습니다. 이렇게 하면 로컬 머신과 배포된 애플리케이션에서 종속 항목의 버전이 같아집니다.

venv를 사용하여 종속 항목을 설치하려면 다음 단계를 완료하세요.

Mac OS/Linux

  1. 격리된 Python 환경을 만듭니다. 
    python3 -m venv env
source env/bin/activate
  2. 현재 위치가 샘플 코드가 있는 디렉터리가 아니면 hello_world 샘플 코드가 포함된 디렉터리로 이동합니다. 그런 후 종속 항목을 설치합니다. 
    cd YOUR_SAMPLE_CODE_DIR
pip install -r requirements.txt

Windows

PowerShell을 사용하여 Python 패키지를 실행합니다.

  1. PowerShell 설치 위치를 찾습니다.
  2. PowerShell 바로가기를 마우스 오른쪽 버튼으로 클릭하고 관리자 권한으로 시작합니다.
  3. 격리된 Python 환경을 만듭니다. 
    python -m venv env
.\env\Scripts\activate
  4. 프로젝트 디렉터리로 이동하여 종속 항목을 설치합니다. 현재 위치가 샘플 코드가 있는 디렉터리가 아니면 hello_world 샘플 코드가 포함된 디렉터리로 이동합니다. 그런 후 종속 항목을 설치합니다. 
    cd YOUR_SAMPLE_CODE_DIR
pip install -r requirements.txt

이렇게 하면 앱을 로컬로 실행할 때 requirements.txt 파일에 선언된 종속 항목만 사용할 수 있습니다. 배포 중에 App Engine에 의해 설치된 종속 항목은 env/ 디렉터리의 콘텐츠가 아니라 requirements.txt 파일의 콘텐츠를 기반으로 합니다.

웹 프레임워크 설치

앱이 웹 요청을 처리하도록 사용 설정하려면 웹 프레임워크를 사용해야 합니다. 다음을 포함한 모든 Python 웹 프레임워크를 사용할 수 있습니다.

특정 웹 프레임워크를 사용하려면 단순히 requirements.txt에 추가하면 됩니다.

Flask==MAJOR.MINOR.PATCH

WSGI 서버 설치

일부 웹 프레임워크에는 WSGI 서버가 여러 개 내장되어 있지만 이 중 프로덕션 트래픽을 처리하는 데 적합한 것은 거의 없습니다. 대부분의 웹 애플리케이션은 Gunicorn, uWSGI, Waitress와 같은 독립형 WSGI 서버를 사용합니다. WSGI 서버 설치, 구성, 사용에 대한 자세한 내용은 애플리케이션 시작을 참조하세요.

Cloud 클라이언트 라이브러리 설치

Python용 Cloud 클라이언트 라이브러리는 작성해야 하는 상용구 코드를 대폭 줄여주는 Google Cloud 서비스에 액세스하기 위한 클라이언트 라이브러리입니다. 이 라이브러리는 높은 수준의 API 추상화를 제공하므로 이해하기가 더 쉽습니다. 또한 이 라이브러리는 Python 관용구를 사용하고 표준 Python 라이브러리와 함께 잘 작동하며 코드베이스와 더 잘 통합됩니다.

예를 들어 Datastore 또는 Cloud Storage의 해당 Python 클라이언트 라이브러리를 설치하여 서비스를 앱과 통합할 수 있습니다.

Cloud Datastore용 Python 클라이언트 라이브러리를 설치하려면 다음 안내를 따르세요.

  1. pip를 사용하여 로컬에서 클라이언트 라이브러리를 설치합니다.

    pip install google-cloud-datastore

  2. 인증을 설정합니다. 자동 인증 처리를 위해 Python용 Cloud 클라이언트 라이브러리를 구성할 수 있습니다. 클라이언트 라이브러리는 Google Cloud CLI를 사용하여 로컬에서 인증도 자동으로 처리할 수 있습니다.

    gcloud auth login

  3. Datastore 클라이언트 라이브러리 참조를 사용하여 앱의 Cloud Datastore 서비스에 대한 지원을 구현합니다.

지원되는 Google Cloud 서비스의 모든 Python용 Cloud 클라이언트 라이브러리 전체 목록은 API 및 Python 라이브러리를 참조하세요.